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1. WHAT IS 5.01? 

1.1 For brief descriptions of the following modules, see 
Table.TXT. 

1.2 A complete list of 5.01 monitor modules: 

* = Disk Related N = New 

BTHINT 

CCIINT 

CDPSER 

CDRSRX 

CLKCSS 

CLOCKl 

COMCON 

COMMON 

COMMOD * 

CONFIG 

COREl 

DATDMP * 

DISSER 

DLSINT 

DPXKON * 

DTASRN 

EDDT 

ERRCON 

FHXKON * 

FILSER * 

FT40D 'S 

FTTM10 I 



b L IKXiO I 

FT40N f feat^^e test switches 
FT50S / 



JOBDAT 

KONPAR * 

LPTSER 

MDXKON * 

MOVIE 

MTASRX 

NULSEG 

ONCE 

ONCMOD * 

PATCH 

PLTSER 

PTPSER 

PTRSER 

PTYSRF 

REFSTR * 

SCHEDl N 

SCNSRF 
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SEGCON 

S 

SWPSER 

SYS INI 

SYSMAK 

TMPUUO 

UUOCON 



N* 



1.3 A complete list of monitor support cusps and their 
documentation : 

* = old cusp which has been updated. 
X = old cusp which has been replaced, 
"tape N" indicates document in dectape image N. 
The Systems Manager's Guide is in the PDP-10 Soft- 
ware Notebook. 



CUSP 

ALCFIL 
BOOTS 

* CHKPNT 
DATDMP 

X DD10 
DMPFIL 
DSKC 
DSKC0 
DSKCl 
DSKC 2 
DSKLST 
DSKRAT 

FAILCD 

FAILDC 

FAILSA 
X FDDD10 

* FILDDT 
FILEX 
FILTST 
GRIPE 

* LOGIN 

* LOGOUT 



COMMENTS 

(called ALCDSK in DSK016.MEM) 
(bootstrap disk file dump and load) 

(dump contents of Level D core blocks) 
(replaced by FILEX) 

(interim routines to print 
remaining amount of storage 
on file structure) 



(file structure damage assessment 
program) 

(failsafe-Level C format tape to Level 
D) 

(failsafe-Level D to Level C format 
tape) 

(failDD - Level D only) 
(replaced by FILEX) 

(Any dectape format-to-disk conversion) 

(Test Program) 

(submit user complaints) 



LOOKFL (type extended entries of a file) 

MONEY 

OMOUNT (See mount command, DSKjZf 16) 
X PAKLOD (replaced by Boots) 
* PAL10 



WHERE DOCUMENTED 

DSK616 

Tape Ld 

Sys .Man. Guide 

Tape 10 

Tape 12 
This letter 
This letter 
This letter 
This letter 
DSK!2fl6 
Tape 10 

Tape 13 

Tape 13 

Tape 1Q( 

Sys. Man. Guide 
Tape 1J0 
Tape 12 
Tape 1J0 
Sys. Man. Guide, 

Level D.MEM 
Sys . Man . Guide , 

Level D.MEM 
Tape lj6 
Sys. Man. Guide 
DSig316, 

Tape 16 
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CUSP 



COMMENTS 



WHERE DOCUMENTED 



* PLEASE 

* PRINT 

* PRINTR 

QUOLST (print a user's quotas) 

* REACT 

SCRIPT (test system with many jobs) 
SETSRC (print and change search list) 

* SYSTAT 

* TENDMP 

UMOUNT (see mount command, DSK016) 



Tape 10 

Sys . Man . Guide 

Sys . Man .Guide 

Tape Xfi 

Sys. Man. Guide 

Tape 12 

DSK016 

Tape 1J0 

reference handbook 

DSKC516, 



1.4 A list of Level C only monitor routines replaced by 
Level D routines: 

DPCINT 
DPCREF 
DSKSER 
FHDINT 
FHDREF 
MDFINT 
MDFREF 
SCHED (now two routines; SCHEDl and SWPSER) 



2. A GUIDE TO THE 5.01 DOCUMENTATION 

2.1 Existing Doc;amentation. 

Except in the area of the disk service, the 5.01 
monitor conforms to the same documentation as the 
previous release (4S72) as modified by the published 
Monitor Change Orders (MCO's). The definitive 
document is the PDP-10 Software Notebook which is 
updated at least quarterly. Other documents which 
pertain are the PDP-10 Reference Handbook and the 
newly published PDP-10 Timesharing Handbook . These 
are modified by the MCO's which are included in this 
release. 



2 . 2 New Documentation. 



2.2.1 Level D.MEM 



This memorandum is the best introduction to the 
new Level D disk service. it is divided into 
four sections — each explaining the disk service 
from a different point of view. The operator. 
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the console user, the programmer and the system 
manager are all given an introduction to the 
details which are more fully described in 
DSK016.MEM. 



2.2.2 DSK016.MEM 



DSK^ie.MEM is the definitive detailed descrip- 
tion of the Level D disk service. it should 
be read by all systems programmers and system 
managers. Since it is an older document, some 
changes have occurred. These are described in 
LEVELD.MEM. 



2.2.3 MONITR.OPR 



This document contains complete instructions for 
building and operating the 5.01 monitor. It is 
extremely valuable to system operators and 
managers. 



2.2.4 TABLE.TXT 



TABLE.TXT is a table of contents for the magnetic 
tape which contains the 5.01 release. it 
divides the release into sections which correspond 
to the DEC-tapes on which they are kept at Maynard. 
Each module is briefly identified by a line of 
text. 

2.2.5 MONSUP.MAN 

This document is a supplement to the other docu- 
mentation and contains information about 5.01 
which is not directly related to the disk file 
system — e.g. the DClOE handler and the TMPCOR 
feature . 

2.2.6 DOC'S, MEM'S and MAN'S. 

On the release tape are many files with extension 
DOC, MEM and MAN. These files are the original 
documentation for the monitor support cusps 
supplied on the tape. in section .1.3 of this 
letter, references to "tape 1^" mean that the 
cusp in question (say FILEX) is dociimented by 
an ascii file named FILEX. MEM to be found in the 
DEC-tape 10 section of the release. 
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2.2.7 FLO'S. 



The three files in the release with extension 
FLO are "english flow-charts" of the internal 
workings of three major portions of the Level 
D disk service. They are intended to give 
insight into the algorithms used by the 
programs but are not at this time completely 
accurate. However, as a guide to the system 
programmer they are still valuable, though not 
as definitive as the listings. 



2.2.8 PATCHES 



Fixes to the monitor made after 5.01 was frozen 
are documented in the patch release included 
in the software kit. 



A FEW WORDS ABOUT THE LEVEL D DISK SERVICE 

The Level D Disk Service included in the 5.01 release is 
extremely complex and very efficient. It has a large number 
of options and parameters which can be used to tailor it to 
a specific configuration. However, since there are so many 
hardware and software options, it is inevitable that some 
combinations arenever tested together. The standard answers 
for the once-/onee^ialogue are given in LevelD.MEM. The 
answers giv4}_il*«^ have all been tested. Hardware configura- 
tions tested have included RMlOB drums, RDIO fixed head disks, 
RPOl disk packs (up to 4) and RP02 disk packs (up to 3). 
Dual RPIO controllers have been used to drive both RPOl and 
RP02 disks simultaneously. Both file and swapping storage 
have been put on all of the above devices, singly and in 
combination. in short, we have tested a large number of 
options but have left some out. 

As a result of the complexity of the options available. Soft- 
ware Trouble Reports for the disk service will have to 
include a great deal of pertinent information in order to be 
serviced. Anomalies of hardware configuration, file structures 
and software parameters will have to be spelled out explicitly 
where pertinent. 



5.01 RELIABILITY 

The 5.01 monitor has been running in some form at Maynard on 
our development PDP-10 since March of 1970. We have subjected 
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the monitor to two kinds of stringent testing in addition to 
the usual unit and integrated tests made for any project. 
First, we have created a program to generate jobs which per- 
form actions according to directions in an ascii file (for 
details see SCRIPT. MEM on Tape 12) . Using this program to 
generate job loads as high as 64 users (on an 80K configura- 
tion) we have exhaustively tested the various areas which 
typically cause trouble with monitors — limit conditions 
expecially. We have scripts which fill up and fragment the 
swapping space, load the 10 channels, exhaust the available 
disk space, etc. These scripts, when run simultaneously, 
cause the monitor algorithms considerable anguish. However, , 
the 5.01 monitor has been taught to live comfortably with 
them. 

Another application of the SCRIPT program has been to generate 
job loads which closely approximate the user job loads which 
we see in-house on our production machine and on other 
machines run by our customers. These scripts, which use all 
the standard language processors and cusps, also run the line 
printer and tape drives to simulate an actual user environment. 
They have been very helpful in debugging the 5.01 release. 

Most important of our reliability tools, however, has been 
our production time-sharing PDP-10. This machine has a user 
population which typically varies from 28 to 36 during prime 
shift (8:30 a.m. to 6:00 p.m.), from 15 to 20 during the 
second shift (6:00 p.m. to 12:00 p.m.) and from to 10 during 
weekends. These three different intensities of use give us 
a good evaluation of the reliability of our monitor under 
different loads. The configuration of the machine is 80K of 
1.8 VIS memory, one RMlOB for swapping on its own DF-10, 
3 RP02 disk drives on another DF-10, 3 magnetic tape drives, 
8 DECtape drives and a line printer. It handles up to 40 
simultaneous users — primarily on hardwired TTY' s but with 
up to eight remote TTY's. The reasonable response job limit 
for this configuration is about 30-34 jobs. Most of the users 
are systems programmers and therefore are capable of putting 
more strain on the system than most users. 

During most of the month of June, precursors to 5.01 have 
been running on the production machine. Reliability has 
proven to be roughly linear with load. During the two weeks 
preceeding the writing of this letter, the crash rate on that 
machine has been: 



1st. shift 
2nd. shift 
Weekends 



Week 1 


Week 2 


1 crash/ shift 
1/2 crash/shift 
No Crashes 


NO CRASHES 
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During this period, the nvimber of users who can be accommo- 
dated with reasonable response has increased over Level C 
by about 5 - or roughly 20%. 



EFFICIENCY AND THROUGHPUT MEASUREMENT 

5.1 WATCH. 

A new feature has been added to the 5.01 monitor to allow 
the user to observe the service he is getting and the 
efficiency of his programs. The WATCH command allows 
each user to have a printout of the time of day at the 
beginning of each command which uses user core and at 
the end, a printout of the elapsed real time and cpu 
time, plus the number of disk reads and writes (in blocks) 
for his program. Any or all of these printouts may be 
requested. Once turned on, they continue until another 
Watch command is given. The default printouts are 
set table at assembly time and patchable. The monitor 
is distributed with the default set to no printout. Type 
WATCH H for a list of the parameter names. See MCO's 
for a detailed description. 

5 . 2 Level D versus Level C - 

Some measurement of the efficiency of Level D versus 
Level C has been made. While any such tests are bound 
by a large number of parameters (exact placement on 
the disk, buffer size, competition from other users) , 
a few general comments apply. 

For a sequentially accessed file stored in contiguous 
blocks on a disk pack. Level C will require a full 
latency between adjacent blocks if they are requested 
by two separate input UUO's. Since Level C allows no 
parallel operations on other disks, the entire system 
is slowed down by the loss of latency. The maximum 
throughput for a single block requested at a time (assiom- 
ing the drive to be always on track) is one block per 
27.5 milliseconds. Level D, on the other hand, will not 
miss the latency if the input request is made in time. 

The more disk drives, controllers and channels you have, 
the more efficient Level D will be over Level C because 
of parallel seeks and data transfers. With four RP02's 
on one controller and one channel, if a random track 
request for a single block is always queued up for each 
drive, the Level c throughput is one block every 65 ms 
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or 15.4 blocks per second. The Level D throughput is 
one block every 15 ras or 57 blocks per second. 

On a user benchmark involving a loop of fortran 
overlays. Level D took less than one- third the real 
time required by Level C on the same equipment. More 
comprehensive measurements of Level D's efficiency are 
under way and will be reported later. 



6. SOME NEW PROGRAMS 



6.1 crash Procedures. 



To speed up the operation of a computer, the 5.01 release 
contains two new support cusps which facilitate loading 
a new monitor, dumping a dead monitor and dealing with 
the dump; they are BOOTS and FILEX. Both these programs 
have their own documentation files on DECtape image 10. 
BOOTS should be kept on a paper tape for loading into 
the machine after a crash. It will save the remains in 
"CRASH. SAV" and reload the system from "SYSTEM. SAV" . 
FILEX will expand the CRASH. SAV file into input suitable 
for FILDDT to analyze. 

6.2 SCRIPT and SCP's. 

Included in the 5,01 release are the SCRIPT program 
(mentioned above) and a number of files with extension 
SCP. These latter are the ascii input to SCRIPT and 
consist of several of our test programs . We have 
included them as potentially helpful examples of SCRIPT 
input . 

6.3 FRM's. 

Files with extension FRM are examples of the forms which 
we use at Maynard to report software errors and fixes. 
They are included because some of our customers indicated 
that they would be useful. 

6.4 DSKC and Friends. 

The files DSKC, DSKOd, DSKCl and DSKC2 are simple DDT 
programs to print the number of free blocks remaining 
on a file structure. They are interim programs to help 
out until the "LEFT" command is implemented. DSKC prints 
out the total number of blocks left on logical structure 
DSKC. Similarly, DSKC0 -1 and -2 print the niomber of 
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free blocks left on units 0, 1 and 2 of logical struc- 
ture DSKC. By suitable use of the ASSIGN command 
(.ASSIGN DSKB DSKC) any file structure can be investi- 
gated. 



6 . 5 Others 



For descriptions of other new programs see section 1.3 

of this letter for the place in which they are documented. 



DOCUMENTATION CHANGES 

7 . 1 Protection . 

The 5.01 file protection scheme is almost completely 
compatible with Level C. The correct description is 
given in Level D.MEM Version 2 dated May 27, 1970 on 
page 27. DSK^16.MEM has an incorrect description. The 
default protection has been set to 057 rather than 055 
at the request of our service bureau customers. This 
means that files in one project cannot be read by 
another project. To change the default, set the symbol 
PRVFIL to your choice at MONGEN time. 

7.2 LOOKUP, ENTER, RENAME. 

7.2.1 Error code #6 may now include BADUFD. 

7.2.2 Note that four word LOOKUP'S are still legal. 
They are distinguished by a non-zero left half 
of word one. 

7.2.3 Rename. 

A deficiency in 5.01 is the inability to rename 
a file and transfer it to a different UFD. It 
must be copied separately. 

7.3 USETO. 

When USETO is set past the end of a file, zeroes are 
written in the file at that time, not later at output 
time. 

7.4 Read Image Mode. 

contrary to DSKj2fl6.MEM section 2.1, read image mode is 
not implemented in either hardware or software. 

-9- 



7.5 CRASH. SAV. 

A new once only question asks the size of CRASH. SAV on 
each file structure. This file is for use with BOOTS 
(see section 6.1 of this letter) and need not be given 
any room if BOOTS is not to be used. 

7.6 ALCDSK vs ALCFIL. 

The cusp described as ALCDSK in DSI^16.MEM is now named 
ALCFIL. 

7.7 FILE command. 

There has been an option switch change in FILE. "D" 
which formerly meant "DIRECTORY" now means delete. 
"L" is the new switch for DIRECTORY LISTING. 



8. DEFAULT CHANGES 

8.1 SYS Protection 

When files are copied into SYS, the operator should 
explicitly set the file protection with PIP or FILEX 
to 155. Otherwise the standard protection of 057 will 
be substituted thereby preventing access by most of the 
users. FAILSAFE and FAILCD automatically restore files 
explicitly to their original protection . 

8.2 Tape Density. 

Default tape density has been set to 800 BPI. 

8.3 Memory Speed. 

The default memory speed for shuffle time computations 
has been set to 1 microsecond. 



9. RANDOM INFORMATION OF INTEREST 

9.1 The DIRECTORY command now requires a colon (":") after 
the device name. 

9.2 There may be a difference between the number of blocks 
allocated to a user (printed by LOGOUT) and the number 
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written (printed by DIRECTORY) if the cluster size is 
is not one. 

9.3 If you want to look at other people's files on UFD'S 
you must explicitly specify any file structures which 
they have access to which are not on your search list. 
The DIRECTORY command will only print files on structures 
in your search list. 

9.4 For a file with protection 455, the owner cannot write 
or delete. He must rename to a lower protection first. 
455 is the protection used by Level C LOGOUT to indicate 
a "preserved" file. 

At our installation, many of our more knowledgeable users 
rename all their files with PIP to have protection 4XX to 
speed up LOGOUT. If they choose to do this under Level D, 
they should make the protection be IXX rather than 4XX. 

9.5 LOGOUT when confirming deletion of individual files 
requires a K and will not accept just a carriage return. 

9.6 The number of core blocks used by the monitor is settable 
at once-only time. Patch symbol CORNUMr each block is 
worth 4 words . 

9.7 If once-only gets a hardware error it puts the controller 
CONI status in the lights. 

9.8 For faster Failsafe operation after refreshing a file 
structure, use the "/N" switch to prevent LOOKUP'S. 

9.9 FTHALT is 1 for this release. 



10. IMPLICATIONS OF SOUP 

Be sure to keep an inviolate copy of all original sources in 
this release as a "father" for SOUP updates in the future. 
We hope to make most future releases with SOUP. 



11. 10/40 N and 10/40 D MONITOR 

The sources for 5.01 will not produce a 10/40 N or 10/40 D 
monitor. Some undefined globals occur. This will be 
rectified in the future with SOUP updates. 



-11- 



12. HOW TO GET ON THE AIR WITH A MAGTAPE DISTRIBUTION 

Since you received your monitor distribution on magnetic 
tape, you will need to read MONITR.OPR sections 1 and 2 
and LEVELD.MEM sections 4.2 in order to make a 5 series 
monitor for your configuration. The magnetic tape con- 
tains all of the monitor sources in a Level C FAILSAFE 
format in project-programmer niomber ljZf,7. Thus old 
customers who already have a disk system, may read the 
magnetic tape with a Level C FAILSAFE onto their Level C 
disk system. New customers will receive a monitor already 
Built for their hardware configuration on a DECtape labeled 
"YOUR MONITOR" (Tape #1) . They must read MONITR.OPR section 
1 and LEVELD.MEM section 12 in order to start running their 
system. 
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MCO 776 

sympt Undefined symbol in DPCREF when assembled for 10/40 
disk system. 

diagj DPCIOC under FTSWAP conditional. 

cure: Remove from conditional. 

DPCREF 

MCO 780 

sympt If monitor assembled with FTHALT=:-1 monitor halts 
whenever user has an ILM. 

diag: The check in APRINT for PI*s in nroqress must not include 
the APR PI level itself. 

cure: Define a symbol in common (APRNOT) which is all PI*s 
levels except APR for CONSZ PI. 

CLOCKl p. 19 

COMMON 

MCO 781 

sympt Monitor halted in CHKTAL routine with negative CORTAL. 

Sharable high data segment (write lock off) is destroyed, 
and then appears to occuoy 256K of core. 

diag: The sharable high data segment had become idle and got 

deleted from core under the false assumotion that a cooy 
existed on the swapping space (not true for non-write- locked 
segments ) • 

curet The FRECRl routine in SEGCON must be made to recognize 
this case and cause the segment to be swapped out. 
However, CORTAL must remain unchanged by this operation. 

SCHED p. 43, 46 

SEGCON p. 42, 59, 61, 64 



MCO 78 2 
sympt 
diagt 
curet 



FILDDT restricted to searching 48K. 

Arbitrary limit imposed in routines SETUP and FETCH. 

Remove the limitation. 
DELETE ^ETCH+6/ CAIL R,30i 

1fetch+7/ port P, J 

CHANGE SETUP+1 MOVEI lt'^^1111 MOVEI T, 111111 

Return if attempt is made to fetch a word outside the 

actual CRASH. SAV file 



FILDDT 



MCO 785 

symo: TTY logical names are lost across DETACH, ATTACH sequence, 
diag: SC.\T?: routine* of SCNSRF usinq DEVLOG as a temporary. 
care: Use AC17 instead after saving on the stack. 

SCNSRF 

MCO 787 

symoi PRINT ignored an inout if the form *.*^ 

diag: Code at BLANKQ was ignoring the wrong terminator. 

cure: Change BLAX^KQ: CAIE CH,33 To BLANKQ s CAIE CH,33 

CAIGE CH,15 CAIGE CH,15 

JHST CMDERR JRST DONE 

JRST DONE JRST CMDERR 

PRINT 

MCO 7B8 

symp: PRINT and UFILE talce an inordinate amount of time to store 
a command file when the system is heavily loaded. 

diag: PRINT and UFILE each do a succession of LOOKUP'S until 

a free name is found that increases in length as the queue 
increases. 

cure: Generate command file names at random using the millisecond 
time UUO. 

UFILE (V005) 
PRINT (V005) 

MCO 789 

symot Deoosit to a high segment arjoears to work, but later orevious 
contents is restored. 

diag: Changed high segment is not swaooed out when earlier copy 
exists in the swapping space. 

cure: Call ZSRSWP after successful deposit to a high segment. 

SEGCON D. 27 



MCO 790 

sympj 1) In REACT, L DEV: FILE. EXT, PROJ, PROG doesn't work. 
Tyoes "? BAD FILE NAME SYNTAX" 

2) ?BAD OCTAL NUMBER TYPED WHEN TERMIMATING "3" EMCOUNTERED. 
diagj 1) FILSPC routine not recognizing •*," as a terminator. 

2) OCTRD routine not recognizing "3" as a terminator, 
curei Add additional tests. 
REACT 

MCO 791 

sympt 1) ENTER to DECtarne fails for no aonarent reason and/or 

2) FILE aopears in DECtape directorv with bln'-ks. 

diags a) Test in ENTER code to prevent ENTER to a file open for 

reading fails spuriously because index in IBLK is cleared 
only on RELEASE. 

b) LH of IBLK is used by dead-reckoning code, 

curei a) Clear index used for test on INPUT CLOSE as veil as on 
RELEASE. 

b) In DTASRN use a temporary for dead- reckoning code rather 
than IBLK (DEVDAT) 

(See further correction in MCO *824) 

DTASRN p. 17, 18 
DTCSRN p. 17, 34 
DTASRN P. 44, 46, 49, 56 

MCO 792 

symoJ HALT in ERRCON in ERRPNT with job # out of range 

(when FTHALT=-1), (Trying to print swao read error message). 

diagt ERRWIT called with high segment # in ITEM and bits set in 
left half. 

curej Replace segment number with associated job # before calling 
ERRPNT. 

SCHED p, 41 
SEGCON p. 60 



MCO 793 

symo: Parity recovery code is not used (intentional), 

diags 4S74 was distributed with the code puroosefully included 
but never called so that it could be debugged later and 
small oatches sent. 

CLOCKl n. 16 



^fCO 794 

symDi Random locations may be clobbered if operator continues 

after a oarity error halt (i.e. PC was in exec mode or more 
than one oarity error in user mode). 

diag: On a parity error halt, the monitor must not attempt to fix 
UD the bad word if parity error did not occur out of the 
sweet) looo. 

curet Check PC on oarity error from exec mode. If not in sweep 
loop, don*t try to fix bad word. 

CLOCKl o. 17 

MCO 795 

sympi Mem parity error message does not orint absolute address 
correctly, 

diag: TACl instead of TAC was being set ud to call OCTPNT. 

cure: Set ud TAC with absolute address, 

ERRCON r>, 1, 16, 16-1 

MCO 798 

symp: High segment MACROoSHR didn't get marked for later delation 
from segment table when MACRO, SHR renamed to MACROoOLD, 

diagt DSKSER now changes filename and extension in DD3 after a 
RENAME so FND3EG never found correct high segment when 
it existed. 

cure I Call FNDSEG before RENAME and call CLRNMl after successful 
RENAME if shared segment being RENAMED, 

UUOCON D. 41 
SEGCON D. 68, 72 
NULSEG P. 17 



MCO 801 

symoi PAKLOD doesn't work on !:?p02*s. 

diagj Test for which kind of drive is wronq. 

curet Move 2 bits. (2 other trivial changes) 

PAKLOD D. 2, 4, 10 

MCO 802 

sympi Monitor halts in APRINT with FT in oroaress on AT''^ channel 
and some lower oriority channel. 

diaq! Out-of-bounds transfer address for user enabled traos leads 

to looD on APR channel until a lower orioritv int«=>rniT;t occurs. 

cure! Treat interrupt occurrinq at trao instrtiction f<^tch as 

though user not enabled for that error and crive an error 
message. 

In addition, more code was added to cone with the situation 
of an ILM that appears to be in EXEC mode, biit really only 
did a JSR on the lower priority interrupt level. This Is 
treated as though ILM occurred directly and lower channel 
is given a legal address to dismiss to. 

CLOCKl p. 16, 18, 19 

SPECIFICATION CHANGE 
MCO 805 

symoi Can*t determine what's a card punch (needed by Fortran). 

diag: Can share CDR/CDP with DVCDR, since one is input and one 
is output. 

cure I Set DVCDR in CDPDOB, 

CDPSER p. 1 

MCO 806 

syrapt MONGEN asks for devtfile specification for CONFIG but 
ignores extension even if supplied. 

diagi No code to check for user supplied file extension. 

cure I Add code. 

MONGEN p. 3 



MCO 810 

symt>: FILDDT outout showed undefined symbols that should have 
been defined. 

diaq: Final oart of monitor symbol table lost because EOF encountered, 

cure I Remove test for EOF but zero window contents before reading. 

FILDDT 

MCO 811 

symat Push down list overflow at channel 7 level. 

diagt Decoding "?UN command at clock level which required deleting 
a fragmented high segment. 

cure: Increase size of NULPDL. 

CLOCKl D. 21, 22 
COMMON o. 21, 23 



SPECIFICATION CHANGE 
MCO 815 

symoj User requests that CDPSER ignore RUB-OUTs in ASCII mode. 

diag: Seems like a good idea. 

cure: CAIN TAG, 177 
JRST NO PUN 

CDPSER p. 19 



SPECIFICATION CHANGE 
MCO 817 

sympt User desires error return on OTJT UUO ^^rhen gets EOT on 
MAGTAPE. 

diagt Sounds like a winnirg change. 

curei Change tJUOCON exit from OUT UIto to also looK for ^OT bito 

UUOCON po 62 

MCO 821 

sympj DSK not available or 

•AS DSK 1 already assigned to JO30. 

diagj Not enough monitor CORE for DISK DEVICE DATA BLOCKS, 

oarticularly when running COBOL jobs which have B ooen files. 

cure: Increase standard size of MTNCOR. 

COMMON 

MCO 824 

sympi MCO #791 has introduced an error such that files get 
garbled on transfer from DECtape or block too large 
error received. 

diag: Storing dead-reckoning block # in DTASRN rather than DDB, but 
DTASRN switches disconnected tapes. Therefore the number 
must be in DDB, 

cure I Store in LH of DLOC (previously unused). 

DTASRN p. 2, 30, 32 

SPECIFICATION CHANGS 
MCO 825 

sympt Cannot do IB (mode 13) to card reader or punch. 

diagt Allow mode 13 and define as I (mode 10), 

curet CDPSER$I CDPIOS+2/DVOUT+DVCDR,, 14403 
CDRSRX$ : CDRIOS+2/DVIN+DVCDH , , 14403 
NOTASC/TRNN I0S,4 

CDPSER p. 1 
CDRSRX p. 1, 6 



MCO 826 

syrap! No error message from rard rjunch when output attemoted and 
device not ready. 

curet Call HNGSTP to -warn user if trouble. 

CDPSER o. 2 

SPECIFICATION CHANGE 



HCO 827 

symp! Cannot do image binary mode output to CDP without handling 
o^m buffers. 

diag: CDP reouired different buffer sizes for each of 3 modes: 
27 - I, IB 
26 - B 
16 - A, AL 

curet Add an entry to all devices dispatch table (at XXXDSP-3) 
which UUOCON will call to set up correct buffer size if 
it finds buffer size = in the device data block. 

CDPSER p. 1, 2 
UUOCON no 32 
DPCINT D. 1 



MCO 828 

symp: Halt in CHKTAL claiming core tables (CURTAB) and count 
of free core (CORTAL) do not agree. 

diag: This is produced only on a swap of high sharable data 

segment. The fix implemented by MCO #781 was not entirely 
correct, 

cure: Instead of using JBTADR (ITEM) to decrement CORTAL, we must 
use IMGOUT because JBTADR was cleared when core given back. 

SEGCON p. 44, 46 



MCO 830 

symoj Monitor Listing have "," delimitina comments at beginning 
of a line. 

diagj This will not work under new (V43) MAC'^0-10. 

curei Write TECO macro and run on all monitor files - 
Files requiring edit are listed belov. 

SCHED 
UUOCON 
PTPSER 
PTRSER 



SPECIFICATION CHANGE 
MCO 831 

symo: For systems with more than 64K,DECtaDes don't have enough 
room to accomodate the crash dumo. 

cure I Use Mag Taoes to save the crash dumn. Dataline Systems 

Mag Taoe routine for saving crashes is merged with DEC Tane 
TENDMP routine. The Mag Tape version of the utility can 
be assembled by defining MAGT feature test switch. 

TENDMP p. 1, 2, 4, 5, 10, 11 

MCO 837 

symoi "PRINTR" does not recognize VTAB as a valid character, 
diagi It should. 

cure I Make it - add VTAB to list of valid stsecial characters, 
PRINTR 

MCO 838 

sympt OPFILE does not like user to delete UFD when logging off 
and leave R or D command oending, 

diagj When UFD missing, OPFILE cannot restore to user's UFD 
since it is not there, 

curet When OPFILE finds missing UFD, have it create a new one. 
OPFILE 



MCO 839 

symoj UFILE pending command (C) is inefficient and inaccurate 
(when user logs off, then on under a new job ^) , 

diag: (1) Search is by job # instead of PPN. 

(2) Command file must be read to determine who user is. 

euro: (1) Make ID ^PN rather than JOB #. 

(2) Include a unique derivative of PPN in command file name, 
so that most LOOKUPS are unnecessary. Also include a 
random number in name so that multiple requests from 
same PPN have a "better" probability of findinq a unique 
command file name on 1st try. 

UFILE 

MCO 840 

symo! Incomrilete syntax checkinq in UFILE - bad syntax not 

diagnosed until OPFILE phase when user has been waiting for 
some period of time, 

diaqj OFILE command scan does not check file names and extensions 
for legal syntax. 

cure: Include length check for 1namE| c and fEXTf < 3 and no 
DOT following EXT (any other break is legal). 

UFILE 

SPECIFIC ATION CHANG E 
MCO 841 

symp: No convenient way of deleting files from DECtapes thru 
FILE command. 

diag I Seems like a good feature to add. 

cure: Add it under "D" command. Change Directory command to "L". 

UFILE 
OPFILE 



SPECIFICATION CHANGE 
MCO 852 



symoj 
cure: 



Customers wanted more features in the Loqout Cusn. 

The following new features have been added: 
D Deletes all files 
F Saves all files 

U Allows you individually deride to save or protect 
all unprotected files 

Logout treats files of all extensions the pam<= as 
compared to the previous version that treates .TMP etc. 
specially. 



LOGOUT 



MCO 862 

symp: Push down list overflow in monitor. 

diagi Need more pushdown list space. However, the job data 
area cannot be expanded. 

cure I Dynamically assign PD list space from monitor free core, 
and move push down list up to it. Move pushdown list 
back to job data area when returning to user via a UTJO, 
The number of 4 word blocks assigned to an extended push- 
doim list is EPL4WD, which can be redefined using MONGEN. 
Current setting is 12 (decimal). Pushdown list overflow 
message now means either: (1) not enough free core, 
(2) extended list overflowed too. A record of successful 
and unsuccessful pushdown overflows is kept in COMMON for 
GETTAB UUO. 

ERRCON 
COMMON 
COREl 



MCO 863 

symp J TIME command info should be in SYSTAT. 

curet Add shuffle and zero core time to SYSTAT, Add GETTAB to 

find nano-seconds per memory cycle. Remove TIME type-out 
of everything except routine for null job and KILO-CORE -SEC. 

CNFTBL table 



item 



location 



use 



21 MEMNSP No. of NANO-SEC PER MEMORY CYCLE 

(SET BY MONGEN) 



COMCON 
COMMON 



MCO 864 

symp: It takes too much core to load the monitor. 



diagi 



cure J 



A significant savings could be effected by having only one 
copy of DDT around instead of both EXEC DDT and USER DDT. 

Version 24 of DDT has been created which is capable of 
running in either exec mode or user mode (by containing the 
code for both ootions and doing conditional execution instead 
of being conditionally assembled). This new version will 
be distributed with the level D disk monitor. 



EDDT 



MCO 878 

symp: MOVIE does not print more than one line. 

diag: Buffer is only that long 

cure: Make buffer long enough for a 64 job system with 128K of core. 
Append a CR-LF at end of text and print only the part of 
buffer stored. 

MOVIE 



MCO 87 9 
symp: 
diag: 
cure: 



FILDDT takes 18.5 minutes of CPO time. 

Symbol table search time is very long. 

Make the current symbol table be COMMON most of the time 
since most symbols are in it and will be found more guickly. 

Also add local symbols in COMMON .A, .B, Z. Use these 

symbols in FILDDT.TXT for all intermediate symbol definitions, 
Symbols starting with . are found first since symbol table is 
sorted in backwards order. 



FILDDT.TXT 



MCO 880 

symp: SYSTAT needed several improvements: 

1. Add shuffle, zcore times 

a. Add help command 

3. Footnote # and @ 

4. Leading zero blank or suppress times 

5. Print (Self) for P,PN if same as this one unless we are 
not logged in 

6. Prepare to make reentrant 

7. Define GOD as Proj . 1, CTY or OPR 

8. Make User Core be MEMSIZ-SYSSIZ 

9. Report login availability 

10. Rearrange null time message 

11. Remove extra %s. 

12. XLIST Hacques 

SYSTAT 



MCO 883 

symp: Improve SYSTAT: 

1. Don't say (SELF) if not logged in 

2. Remove unused code 

3 . Round swap ratio correctly 

4. Remove extra comma on file structures 

5 . Add comments . 

6. Print n+nk for job size 

7. Print #jobs in system/use/logged in/detached 

8. Rearrange some code 



MCO 884 

symp: MOVIE does not print status of highest job logged in. MOVIE 
wastes 3 columns by printing mill job status and wastes the 
letter A for null job. 



cure: Start job status with job 1 and go through HIGHJB. 
low segment of job 1 in core map, B for job 2, etc, 



Use A for 



MOVIE 



MCO 887 

symp: Occasionally the crash procedure does not halt with the 
PC - 525252. 

diag: Continue switch bounces and an illegal UUO is executed. 

cure: Put hald . in AC 10 and then halt with PC pointing to 10. 
If MA also set to 10, then continue switch bounced but 
caused no problem. 



MCO #D-2 

symp: EDDT prints octal numbers when symbols are requested. 

diag: DDT prints just octal if nearest symbol is more than 100 away. 

cure: change to 1000 for exec DDT and FILDDT. A ^B 

EDDT$ : 

MCO #D-3 

symp: Many tape read errors on FAILSAFE. 

diag: standard density is 55'6: tape written at 800. 

cure: change STDENS in COMMON to 3 . so standard density is 800. B ^C 

MTASRX$ : 

MCO #D-7 "Level C bug" 

symp: NXM @ 26440 (ANYDEV+15) 

diag: Item set wrong. 

cure: Do a SOS on -1 (PDP) not (PDP) , - which is where item is 
saved. E ^F 

SEGCON$ : 



MCO #D-10 "Level C bug" 

symp: System hung not responding to 1*C. 

diag: A job in core has swp bit on because high seg is swapped out. 

The SCNJOB algorithm in swapper does not count jobs in core with 
SWP bit on. G )-H 

cure: Make SCNJOB test JBTHDR for zero rather than SWP bit in order to 
ignore jobs. 

MCO #D-13 

symp: FAILSA changes access dates when it saves files. 

diag: Not using CLOSE bit 32. 

cure: Change CLOSE FIL, to CLOSE FIL,10 
CLOSE CHK, to CLOSE CHK, 10 
Add CLOSE'S before RELEAS'S where necessary. 

MCO #D-14 

symp: Changed message ASSIGN MTA# FAILSA & THEN RESTART to ASSIGN 
MTA# FAILSA & THEN START. 

MCO #D-15 

symp: When restoring FAILSA overwrites existing disk files if the same 
file on tape has an equal creation date and time (on if the disk 
file is older) . 

cure: As of V.26A FAILSA only overwrites existing disk files if they 
are older - not if the tape file is equal. 

MCO #D-20 

symp: K for CRASH. SAV set to 262143 when a file structure is defined. 

diag: When a file structure is first defined, K for CRASH. SAV is set 
arbitrarily large by once-only. This forces refresher to 
allocate maximum amount of contiguous space possible in one 
retrieval pointer - determined by the size of the cluster 
count field in the retrieval pointer. 

cure: Make the documentation clearer. 

Note that K for CRASH. SAV is set to 262143 by once-only when 
a file structure is defined (e.g. when you dissolve and 
recreate the file structure) . 



MCO #D-22 

symp: Refresher takes a long time. 

diag: refresher zeros all unused blocks in all files it creates for 
security reasons . 

cure: Set protection to 557 to take care of security problem and 
do not clear blocks. 



MCO #D-24 "Level C bug" 

symp: Garbage names for dormant segs in TBTNAM table. 

diag: FNDSEG expects extension in DEVEXT (DEVDAT) to be "SHR" and it 
is not because UREMAP calls lOWAIT, which changes DEVDAT. 
Happens on GETSEG UCO of a sharable high seg while active I/O 
on some channels. 

cure: PUSH, POP DEVDAT around call to lOWAIT. 

MCO #D-27 

symp: Swapping space disappears. 

diag: Core parity err lights an error bit in lOS, so swapper tries 
different loc on disk to swap. 

cure: Reference bad loc, so OPU will notice error (and stop) 

FHXKON$ : 

MCO #D-3Q "Level C bug" 

symp: PI7 glows a bit, expecially in 64 job system. 

diag: CQMCNT gets very large, but there are no waiting commands, that 
is no sign bits set in TTYTAB. This happens when 1^ C is sent 
over a PTY, but I don't know why. 

cure: A cure that adjusts COMCNT and at least saves PI7 time is to 
decrement COMCNT each time: 

1. the entire TTYTAB is scanner 

2. No delayed commands are found 

3. No other waiting commands are found 



MCO #D-36 

syitip: 

diag: Core blocks have timing problems. 

cure: Interlock FNOFIL routine as it it were a sharable resource. 

MCO #D-37 

symp: Reduce possibility of timing problems at the cost of some 
speed. 

cure: 1 Monitor buffer instead of 2. 

MCO #D-38 "Level C bug" 

symp: System hangs in tight loop with Pl4 (scanner in progress) 

diag: Monitor waiting for CCI buffer empty flag to go off. Never does 
if PDP-8 is stopped. 

BTHINT$ : 

MCO #D-39 "Level C bug" 

symp: Loop with Pi 4 (scanner) in progress. 

diag: Talk ring is not complete. 

cure: Count TTPLEN times (no. of TTY+PTY+CTY lines) then quit if not 
got back to beginning. 

SCNSRF 

MCO #D-48 "Level C bug" 

symp: Reproducible NXM with SPY UUO. 

diag: Arg too big so NXM adr set up in user relocation. 

cure: Give error return if LH of user arg is non-zero or RH is 
greater than size of Monitor (SYSSIZ) 



MCO #D-53 

symp: Hard to measure response time of programs. 

dure: Add a command called WATCH which causes monitor to auto- 
matically print incremental job statistics. WATCH DAY causes 
the monitor to print the time of day as (HH?MM.SS) when the 
user started or continued a program with a monitor command, 
e.g. START, CONT, R, RUN, COMPIL, SYSTAT, etc . WATCH RUN, WAIT, 
READ, WRITE causes the monitor to print the incremental run 
time, the wait time (time since user started or continued 
program) , the incremental number of disk blocks read and the 

incremental number of disk blocks written as (SS.HH, ^S.HH 

RR, .WW) whenever the console is returned to monitor mode 
via CONTROL C, EXIT, HALT, ERROR IN JOB, DEVICE XXX OK? 
WATCH with no arguments eliminates the printing of all 
incremental job statistics. Any combination of the five 
arguments may be typed in any order. Each occurrence of the 
WATCH command clears the status of previous commands. The 
monitor does not print statistics for commands which do not 
start up jobs, such as ASSIGN, and PJOB. When a user logs in, 
his job is set to watch all incremental statistics. The 
system administrator can change this initial setting by 
redefining MONGEN symbol SETWCH from 370000 to any other 
combinations of bits 1 thru 5, as follows: 

bit 1 = setting for DAY, bit 2 = setting for RUN 

bit 3 = setting for WAIT, bit 4 = setting for READ, 

bit 5 = setting for WRITE 

Note: That defining SETWCH to be with MONGEN, causes 

the monitor to print no incremental statistics . 

If the user types an invalid argument to WATCH, the monitor 

responds with : 

ARCS ARE: DAY, RUN, WAIT, READ, WRITE 

Note that the order of the error message is the same as the 

order of output. Thus a user who forgets either the 

arguments or the significance of the statistics can find out. 

Note also that the incremental commands TIME and DSK terminate 

an increment in the same way as the incremental job statistics 

which have been activated by WATCH. These job statistics 

are included inside brackets as an indication to the user that 

the type out is incidental to his major interests and is not being 

typed out by his program. The single space between each pair 

of niomber is always typed, whether the number is or not. Thus 

is is possible to tell which statistics are being typed without 

seeing the WATCH command. 



MCO #D~58 "Level C bug" 

symp: A user program can turn off UWP for a spy seg and can write 
in monitor - 

diag: Check for spy seg is not correct. 

cure: Give error return if high seg is spy seg. 

SEGCON 

MCO #D-59 "Level C bug" 

symp: FILDOT is very slow. Also typing one control C while it is 
running returns to command level immediately. 

diag: TTCALL UUO is done after every word in a word search. 

cure: DO not to TTCALL if input is from a commaid file. 

EDDT 

MCO #D-71 "Level C big" 

symp: NXM on getting a non-monotonic file. 

diag: Expand algorithm in COMCON assumes monotonicity. 

cure: Give ADR check in non-monotonic. 

EDITED 

MCO #D-80 "Level C bug" 

symp: Mem parity error in high seg incorrectly reports parity to be 
beyond end of low seg. 

diag: If high seg is below low seg, the difference is negative. 

G ^H 
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TABLt OF COMEMS — PDP-115 MOUITQR UlSTjNG 

/T^^/CMF TS ic APR 70 V414 
V411 THE FOLLO-INU lb THE OROE« OF CONTENTS oF The moMTOR SOURCES AW SUPPORT CUSPS 
V4U ON TnE DEC rjHMSHED UISTHGS FOR THIS MONITOR, THEY ARE ARRANCEO IM THIS OROER FOR 
V411 CO'.Vf.'v.lErCE TO ThE nPERATOR TO AID IN ASSEMaLIhC THIS MONITOR AND SUPPORTING PROGRAMS, 

V411 flUE MAME DESCRIPTION 

V411 TA^LE.TXT TABLE OF CONTENTS (THIS LISTING) 

V4H tYbTLM.MAP LOAQEK (SYSTEM SUIUDEH) STORAGE HAP 

^*11 GLOb.XHF CUOBAI. CROSS REFERENCE (ALL. GLOBAL SYMBOLS) 

V41S ALL CCL FILES FILES To ASSEMBLE AMD PRODUCE BINARY 

AND LISTING FILES OF ALL MONITOR AND 
CUSP SOURCES, 

^<U "Of^GEN.LST CROSS REFERENCE LISTING OF CONf IGURATION OEPIN|TION PROGRAM, 

V41X .•"OMTOH SOURCE 

y*Jl LISTINGS CROSS REFERENCE LISTINGS Of MONITOR SOURCE FILES FOUND ON TAPIS 

\*,ii 4 THROUGH 6, INcLUSiVEi EXCEPT FOR ROUTINES ASSOCIATED WITH DISKS 

V414 riSK LISTINGS CROSS REFERENCE LISTINGS OF DISK ROUTINES - TAPE W 

V<11 CUSP LISTINGS CROSS REFERENCE LISTINGS OF MONITOR SUPPORT PROGRAMS 

V411 (WOT FURNISHEU) USED WITH THIS mONITOH, 



TABLE OF CONTt\TS — POP^lO MONITO" 
CTHESE TAPE. NUMBERS CORHESPU-NU TO Tut FASTER UEcTaPE NUMBERS] 



FILE NAME 



DtScalPTION 



TAPE ll YOUR homITjN 
FA1LCD,SAV 



[CREATED POM UtLIVERY OF mAcNJNEJ 

CIS "IOt created for subsequent SOFTWAHE UISTRIBUTI0NS3 
RESTORE LEVEL C MAGTAPE TO LEVEL D DISK 
tUSEO IF MONITOR IS DECIVEReD ON MAGTAPE] 



TAPE it lU/4-2 MO^.lTOR MAKER 



4N7Z.REL 

12C,16K 

SPM0N,16K 

SPM0N,32K 

SPM0Nt48K 

MONGEN.SvE 

PIP.SVE 

MACRO, SVE 

LOADER, SVE 

TAPE 3| ASSEMBLY TAPE 

TABLE, TXT 

MONITR.OPR 

TENOHP.MaC 

MONGEM.MAC 

MONGCN.SAV 

FlUDOT.TXT 

S.HAC 

FT4aD,MAC 

FT4aN,MAC 

FTSBS.MAC 

FTTMlB.MAC 

CONFIG. MAC 

S'NDLiCCL 

S4NBTH.CCL 

S4DRL,CCL 

S4DBTH,CCL 

SSeRLiCCL 

S50BTH.CCL 

SSBRLX.CCU 

Boers, MAC 



LIBRARY FILE TO MAKE 1«!/4|3 MONITORS 

STANDARD 16K XiS/3S! MONITOR [NEEDED TO LOAD MONGEN.SVL] 

SPECIAL 16K t'Cm MONJTOH CSAVtS IN l»/4a, 10/bfcj FORMAT] (.NEEDED TO LOAU lU/48» 1«/5B MONITORS] 

SPECIAL 32k 10/30 MONITOR CnEEDED TO [oAD ia/4e, ltf/5B MONITORS] 

SPECIAL 48k iV/lVi MONITOR CNEEOfD TO LOAD 10/4B, IB/SB MONITORS] 

MONITOR GENERATOR (CONFIGURATION DEFINITION) CRUNS U'^DER 1215, 16K OR SPMON] 

PERIPHERAI. INTERCHANGE PROGRAM CRUNS UNDER 120, 16K OR SPMON] 

MACRO ASSEMBLY PROGRAM i^W% UNDER 12»16K OR SPMQN] 

RELOCATING LOAOER CRUNS UNOER 120,16k"OR SPMON] 



THIS FJLE (TABLE OF CONTENTS) 

MONITOR ASSEMBLY AND LOaOII^G INSTRUCTIONS 

LOAD/OUMP MONITOR ON DtcTAPE 

MONITOR GENERATOR-CREATE CONFIG, MAC VIA DIALOG 

MONITOR GENERATOR <SAV FILE) 

FRDDT INPUT COMMAND FIlE 

MONITOR PARAMETER DEFINITIONS (LISTED ONLY IN COMMON) 

CONFIGURATION DEPENDENT FEATURE TEST SWITCHES FOR (NON-SNAPPING) OISK 

CONFIGURATION DEPENDENT FEATURE TEST SWITCHES FOR NON-OISK (NON. SWAPPING) SYSTEM 

CONFIGURATION DEPENDENT FEATURE TEST SWITCHES FOR DISK (SWAPPING) 

FEATURE TEST SWITCHES FOR TMIBB MAG TAPE CONTROLLER AND DF.IB DATA CHANNEL 

SAMPLE CONFIGURATION DEFINITION FILE (MONSEN OUTPUT • SEE COMMON) 

ASSEMBLE ENTIRE 10/4eN . REL ONLY 

ASSEMBLE ENTIRE 10/400 - REl * CRF 

ASSEMBLE ENTIRE 10/4BO . REu ONLY 

ASSEMBLE ENTIRE 10/400 . REL * CRF 

ASSEMBLE ENTIRE 10/50 - REU ONLY 

ASSEMBLE ENTIRE 10/50 « REL • CRF 

ASSEMBLE ENTIRE 10/50 On DSK - REL ONLY 

LEVEL DISK BOOTSTRAP lOAOeR (LOAD MONITOR FROM 

DEVlFlLE,EXTCP,PN3) 



T*Pt 41 rOrlTTr: sJuHCt FILES 

f-Tril T UATa LIN.E SCANNER ♦ CQf.PUnR-COHPUTER-lNTERFACE - OEVICE OEPENDEmT PART OF TE|,ETrPt SEHVtCE 

CCII.T COMPUTER'COMPUTER^lJTEHFACt - DEVICE OEPENOENT PART OF TEtETVPE SERVICE 

cDP<i(.'-< CAST PUMCH SERVICE ROUTINE 

CDi<S-(X CARi) HEAOER SERVICE ROUTINE FOR PDP-lU ( CR"10 ) 

CL'^CSs JOS StHEOUtlNB ALGOHTIHm FOR NON-SWAPPlNGi I,E,> 1B.4B| SYSTEMS 

CLilC'l CLOCKiCONTeXT Si^lTCHING AND JOS ST*RT AND STOP ROUtlNES 

i^KlM HIGH PRIORITY pi^OCtSSOR INTERRUPR ROUTINE 

ruOC< LOW PRIORITY CLOCK pTERRUPT ROUTINE 

■J-CSS ROUTINES TO START AND STOP USER JOBS 

COHcivj COMMAND OECODtR AND SAV£UET ROUTINES 

tOMCuf< MONITOR COMMAND DECODER AND COMMAND ROUTINES 

' O'^CSS COMMON SUBROUTIvES USED BY MONJTqR COMMANDS 

.'4vge;t The save and stT monitor commands 

r.Oii-';J COMMON DATA storage for monitor (INCLUDES SAMPLE C0NFl5,M*q) 

■ ."AC SYSTEM PARAMETER FILE ASSEMBLED WITH ALL FILES (LISTED HEBE ONLY) 

I Ji.FlG.KAC SAMPLt CONFIGURATION DEFINITION FILE (MONCEN OUTPUT) 

COHti CURE ALLOCATION AND SHUFFLING 

DISSLR CRT OlSPLAY SERVICE ROUTINE FOR MODEL 3<0 OR TYPE 30 DISPLAY 

OLSI-.T DATA LI«E SCANNER - DEVICE DEPENDENT iNT, SERV, FQR USE WITH TELETYPES 

54f|kLl,Cr.L ASSEMBLE THIS TAPE FOR 1I«/*0N • REL ONLY 

s4DRL4,r:cL ASSEMBLE THIS TAPE FOR lB/*eO • REL ONLY 

S5/«L'f,CCL ASSEMBLE THIS TAPE FOR 10/S0 » REL ONLY 



TAPE S| MONITOH SOURCE FILES 



DPCI\'T CLEvEt Ca 

DPOInT CLEvEU C3 

DSKSER CLEVEt C] 

DTaSRN DECTaPE service F0« PDP-ia(TLl-b5) DECTAPES ANO new ntE STBUCTUflE 

EDOT EXECUTIVE MOOt DDT (DTNa'IIC OEHUGGINC TECHNIQUE) 

ERRCON MONITOR DETECttD ERROR MESSAGE ROUTINES 

jOBDAT symbol OEFINltlONS FOR J09 3AtA AREA (BOTH SOURCE CODE ANO ASSEM9LV LISTINGS) 

lptser line printer service routine 

movie snapshot of system is printed on lpt by this routine 

MTaSHX MAGTAPE SERVICE ROUTINE FOR PDP-10 MAGTAPE CONTROLLER(TTM10A*TMiBB ) 

NULSEG DUMMY HIGH USER SEGMENT HANouING ROUTINES 

ONCE ONCE ONLY OPERATOR DIALOGUE FOR MONITOR STaRT»UP(NON"D|SK OR DISkI 

PATCH PATCHING SPACE 

PLTSER CALCOMP PLOTTER SERVICE ROUTINE 

PTPSER PAPER TAPE PUNCH SERVICE ROUTINE 

PTRSER PAPER TAPE REAPER SERVICE ROUTINE FOR POP«1B<POP»6 ) 

PTYSRF PSEUDO-TELETYPE SERVICE ROUTINE (FULL DUPLEX) 

SCHEOl SCHEOULAR AND SWAPPER ROUTINES 

S4NSl5,CCL assemble This tape FOR li«/«aN » REL ONLY 

S«0Rl5.CCL ASSEMBLE THIS TAPE FOR 10/«0O • REL ONLY 

S50RL5.CCL ASSEMBLE THIS TAPE FQR 10/90 - REL ONLY 

TAPE 61 MONITOR SOURCE FILES 

SCNSRF TELETYPE SERVICE • NEW FULL DUPLEX . SCANNER INDEPENDENT (USES CCJINT, OH 0L8INT) 

SECCON HIGH USER SEGMENT HANDLING ROUTINES 

SYSIM MONITOR INITIALIZATION 

SYShAK make «;0B 1 BECOME THE NEW MONITOR (OVERLAY EXISTING MONITOR) 

TMPUUO IN CORE STORAGE ROUTINE FOR CCL FILES' (TMPCOR UUO) 

UUOCON UUO TRAP HANOLCR ANO OEvICE INDEPENDENT UUO ROUTINES 

UUOCON UUO TRAP HANDLER AND DEVICE INDEPENDENT UUO ROUTINES 

I0C5S COMMON 10 SUBROUTINES 

S4NRL6,CCL ASSEMBLE THIS TAPE FOR IB/fBN . REL ONLY 

S40RL6.CCL ASSEMBLE THIS TAPE FOR 10/400 • REL ONLY 

S$0RLi.CCL ASSEMBLE THIS TAPE FOR l^/'B - REL ONLY 



TAPE /I l./5^: NOuITqR RtU FiLtS 

COhfDN.RLU COMMON QATA STORAGt (SAMPLE <5YSTEM CONFIGURATION) 
COMMuO.RtU LEVEL COMMON OJSK OAT* STORAGE (SAMPLE OJSK CONFIGURATION) 
SS.l.REL V-'/b<f RELOCATABLE BINARY Ula'ARy FILE 

TAPL 81 ^C'JITOR SyPPORT CUSPS 

aLCFIL.maC ALLOCATE FILE SPACE 

iLCriL.Sti' 

CHKP>iT,M4U CHECK POINT CUHRtNT CHARGE FILE AND START NEW ONE 

CM*B,,T,SAY 

iCCT.SVS SAMPLE PASSWORD FILE REaD 8Y LOGIN 

AUXACC.Sva SAMPLE PUBLIC DISK QUOTA FILE HEAD BY LOGIN 

;.Si<LST.MAC LIST OJSK FILE STRUCTURE (MFD#UFOS|SATS,ETC) 

T'SmST.SaV 

fAlLSA.v!AC SAVE ANO RESTORE DISK USING MACTaPE 

FAIl!jA,SAv« 

LOGI-J,M*c VALIDATE PASSWORDS AND CONTROL SYSTEM ACCESS 

LOGI j.SHh 

LOUOUT.PAC LOG USER OFF SYSTEM 

LOGOUT, S^-H 

F]LD[;T,Sai/ file DOT - EXAMINE A FIlE (CRASH, S*V> C*SSEMBLE FROM E0DT,M*C3 

caBTH.cCL ASSEMBLE TmIS TAPE FOR BOTH REL AND LISTING 

LOOKFL.MAC LOOK AT A FILL'S EXTENUED LOOKUP/ENTER ARGUMENTS 

UOOKFL.SAV 

GRIPE. MAC ENTER USER GRIPES IN C3,33 UFD AS A FILE 

GRIPE, SAV 

TAPE 9| "OiMlTOR SUPPORT CUSPS 

'■ONEY.MAt LIST tHARGE FILES AND PrINT TOTALS 
t-ONFY,bA\( 

OMOUNT.MaC PROVIDE OPERATOR JNTERFaCE FOR FILE AND MOUNT COMMANDS 

C'MOUMT ,SA 1/ 

PLEASE, MAC PROVIDE OPERATOR CONVERSATION (PLEASE COMMAND) 

PLEASE. SaV 

PRINT, MAC ENTER FILE NAMES IN PRJ',|TR QUEUE FOR LPT 

PRINT, SAV 

FRt\TR,MAC OPERATOR CUSP To PRINT FILES FRQM QUEUE 

PRIK'TR.SAV 

REACT, MAC PREPARE PASSHOHO AND QUqTa FILES ( ACCT, SYS, AUXACC.SYS, QUOTA, SYS, STRLST, SYS) 
REACT, SAV 

SETSWC.MAC SET AND/OR PRINT JOB FIlE STRUCTURE SEARCH LIST 
SCTSRCSaV 

systat.'mac type System summary on tty <systat command) 
systat.sav 

UMOUnT.MaC enter file names (FILE COMMAND) OR REMOVABLE 

VOLUME NAMES (MOUNT COMMAND) IN OPERATOR QUEUE 

LjMOUNT,SAV 

c9bth,ccl assemble This tape for 30th rel and listing 
notice, txt sample notice of the day printed by login 

FlLEX,MAC 

FiLEx,SAv CORE Image processing program 



TAPE 101 



DOCUMENTATION 



0sk?l6.mtm level d«e disk project specification 

systat.mei description of SYST*T COIMAMD pbintout 

fallsaiduc docuhtntation foh uevlu f4i1.safe 

errob.frli software error form (cash amp other monitor and cusp errors) 

UMRmCO.FHM UNRElEaSED monitor change ORDER FORM {ABBREVIATED MCO», 

CSPSUB.FRM CUSP SUBMISSION FORM FOR UPOATINC SYS' 

BOOTS. MEm DOCUMENTATION FOR BOOTS 

LOOKFL.MEM DOCUMENTATION FOR LOOKFl 

GRIPE, MEM DOCUMENTATION FOR CRJPE 

DATRMP.MEM DOCUMENTATION FOR DATDMp 

OSKRaT.MEM DOCUMENTATION FOR OSKRAT 

tstrun.frm software test run results Form 

filex.mem oocumtntatlon for fiuex 

ouolst.mem documentation for ouotst 

PLEASE, MEM DOCUMENTATION FOR PLEASe 

UHOUNT.MEH DOCUMENTATION FOR UMOUNT 

OMOUNT.MEM DOCUMENTATION FOR OMOUNT 



TAPE Xil 



DOCUMENTATION 



mONSUP.MAN DESCRIPTION OF OCXBE AND TmPCOH UUO 

oNce.rLO ONCE ()nly flow LOCIC 

rJusER.ruo level d file service flow logic 

RCFSTR.FLO level DISK REFRESHER FLOW LOC|C 

LEVELD.MEM guide TO S SERIES MONITOR fRE SySTEm(lEVEL 0) 



TAPE 12 t 



TEST PROGRAMS 



PARtST.MAC TEST MCMORY PARITY ERROR RECOVERY 

riLTST.HEN DESCRIPTION OF FII.TST LANGUAGE 

riLTST.MA? FILE SySTEM TEST INTERPRETER ' 

TiStsa.MAC SERIES OF LEVEL D FILE SYSTEM TESTS 

SCRIPT, HEH DESCRIPTION OF HOH TO RUN SCRIPT 

SCRtPT,HA9 TEST SySTEH BY SIHULATING MANY JOBS FOLLOWING A SCRIPT 

tOTALiP* PRINT SCRIPT STATISTICS 

LlNFOR.SCP LINEO/PORTRAN SCRIPT 

CPYSVS.SCP COPY S¥Slt,SHR,»,SA¥ UNTIL OUQTA FILLS UP SCRIPT 

DCLALWiSCP DELETE ALL PILES ]N TEST DIRECTORY SCRIPT 

DMPFIL.MAC DUMP DISK OR DECTAPE BLOCKS JN OCTAL 

FRGSMP.SCP script TO FRAGMENT SWAPPING SPACE 

DMPFIL.HEM DESCRIPTION OF OMPFIL PROGRAM 

TCCMAC.SCP TCCO/MACRO SCRIPT 

PARIO.SCP 

DSKC.SAV print NO. OF BLOCKS LEFT ON FILE STRUCTURE DSK 

OSKCCiSAV PRINT NO, OF BLOCKS LEPT ON UNIT DSKC^ 

C12BTH.CCU ASSEMBLE THIS TAPE FOR BOTH REL AND lIsTING 

OSKRaT.HAC examine a LEVEL FILE STRUCTURE FQR ERRORS 

DSKCl.SAV PRINT NO. OF BLOCKS LEPT ON UN|T OSKCl 

OUOLST.HAC TYPE JOB'S QUOTAS ON ALL PILE STRUCTURES IN SEARCH LIST 

riLLUP.HAC FILLUP DISK TO TEST THIS CONDITION 



T*Pt 131 LtVEL D CUSP UPE 

FAlLCD.»1AC RESTORE LEVEL C MA&TAPE TO LEVEL DISK 

F*1LCD,S*V 

FAlLCD.Df't DOCjMtNTATION FQR FAILCD 

FAILOCMAC SAVE LEVEL DISK ON LEVEL C MAGTAPE 

FAILOC.SAV 

FAlLDC.OGf OOCUMtNTATION FOR FAJLUC 

cisrth.ccl assemble this Tape for soth rei, ano listing 
tape x4: level monitor file svstem sources 

commoo.^^ac common oata base for disk Data 

SiMAC SYSTEM PARAMETER riLE ASSEMBLE WITH ALU rlWES tLl'TEO «ITH COMMON ONLY] 

CONFIli.MAC SAMPLE CONFICUHaTION PEFINJTION FILE (MONGEN OUTPUT) 

COMMOP.MAC LEVEL D FILE SYSTEM DATA BASE 

tjATOMP.MAC LEVEL D FILE SVsTEM DATA BASE DUMPER 
PATDmP.MaC DATA BASE DUMPER (EXEC OR USER MODE) 
CNCm'^O.iaC disk once only DIALOG 

refstr.mac disk refresher 

SWPSeR.maC level SWAPPER INTERFACE ROUTINES 
S4QRi4,CCL ASSEMBLE THIS TAPE FOR 1U/40D • REL ONLY 
S5HH14.CCL ASSEMBLE THIS TAPE FOR lB/50 - REL ONLV 

TAPE 15« LEVEL D MONITOR FILE SYSTEM SOURCES 

HLSERiMAC DISK INDEPENDENT FILE SYSTEM 

kONPaR.maC CONTROLLER PARAMETER FIlE 

OPXkON.maC RPla KONTROLLERCS) ROUTINE 

FHXkON.maC RClB KONTROLLER(S> ROUTINE 

^<DXKON,MAC RAld KONTR0LLE«<S) ROUTINE 

S4Dri5,CCL ASSEMBLE THiS'TAPE FOR 10/40D « REl ONLY 

S5i5Hl5.CCL ASSEMBLE THIS TAPE FOR 10/9B - REL ONLY 

TAPE 161 bill/bag] COMMUNICATIONS 

S6B0I,PAL POP-ei ROUTINES FQR 6810 USEO WITH POP-10 

S68ei,LST LISTING OF POP-B] 680 ROUTINES 

PAL12,141 SOURCE OF PAL ASSEMBLER (PDP«B) TO RUN ON POP-IB. 

PALlOtOPR PAL ASSEMBLER INSTRUCTIONS 

PALIC.SAV PAL ASSEMBLER (PDP-6) To RUN ON POP-IB, 

TAPE 171 MORE MONITOR TEST PROGRAMS 

WORKER. SCP SCRIPT TO SIMULATE IN-HoUSE T,S, SYSTEM 

UPDATE, SaV program USED |N SCRIPT TO TEST SIM, UPDATE 

UPDATE, SCP SCRIPT TO TEST SIMULTANEOUS UPDATE 

LOGLOG.SCP script to TEST SIMULTANEOUS LOGIN/LOGOUT 

FILER, SCP SCRIPT TO TEST USE OF FILE COMMAND, 



CHAMGES LISTED In OHOtR OF mOST RECENT FIRST 
FIRST VERSION If- UHICH CHAMGE APPEARED WILL Bt PUT OM EVERY LINE 
SO CHANGED AT LEFT HAND MARGIN , 

CHANGE From Vtl6 TO V?17 
DELETED REFERENCES TO PDP-6 AnO 
HALF DUPLEX SCAKNER 29 JUN 7» 

CHANGE TROM VERSION V?15 TO v;i6 23 JUN 7" 

TAPE 3| ADDED BOOTS, MAC 

TAPE 81 ADDED C8BTH,CCLiL00KFL,MAC,L0OKFL|SAV,M1.EX ,SAV 

TAPE 9\ ADDED PRINTS, MAC,PRINTR,SAViCRIPE,HAC,GrIPE,SAV,C98TH,CCLiFILEX, MAC 

TAPE iai ADDED ERROR, FRm,UNRMCO,FRM,CSPSuB,Frm, BOOTS, MEM, 

L0OKFL,MEM,GRlPE,MEM,UATDMP,MtM,OSKRAT,»itM,TSTHUN,rRM»QUOLST,MEM 
TAPE 121 ADDED LlNFOR.SCP, TESTSZ.SAV, SCRIPT .MCMiDHpriU , MAC 

DMPFlL,MEM,DMPFlL.SAViTECHAC,SCP,D0lii!F,MACiOniBF,SAV 

D0iOF.HEM|Cl2BTH,CCL<USKRAT,MAC,DSKRAT,SAV,aU0LST,MACiQU0LST,SAV 

REMOVED SCRIPS 
TAPE 131 ADDED FA[LOC,MaC.FaILOC,SAV,FAIlDCiDOCiC13BTH.CCL.PIP030,OOC 
TAPE i7l ADDED THIS WHOLE TAPE OF TEST PROGRAMS 

CHANGI FROM VERSION V*!* TO V*1S 6 MAY 7ii 

TAPE 8| ADDED FlUDOT.SAV 
TAPE iZt 'ADDED SCRIPS 

THE Tapes were entirely RE0RGANI2E0 for S SERIES MONITOR, 

THE TAPE NUMBERS WERE ARRANGED TO BE THE SAME AS THE LIBRARY TAPE NUMBERS 

roR Ordering tapes 

CH*NI;E from VERSION Vfll TO V?],2 12 JAN 7iS 

1. REMOVE IJOBS FROH TAPE 5 

2, REMOVE RENMON.MANiMONSPL.MAN AND RENMON,S01 FROM TAPE 8, 
i, REMOVE S.MAC AND COMMON.HAC FROM TAPE 9. 

*i CHANCE 120, 1«K to 121. 1»K ON TAPE 9, 

CHANGE PrOH version V4te TO V^tl 11 JAN 70 

li ADDED TABLE OF CONTENTS OF A DEC FURNISHED LISTING rOR THIS MONITOR, 
2. REMOVED SYSTEM MAP ANO ClOB.XRF FROM TAPE 1, 

CHANGE FROM VERSION V407 TO V*!^ 6 JAN 70 

1. HOVEO ALL DISK RILATEO ROUTINES TO TAPE «■ 

2. AOOEO IJO8eii02|04 - THE BATCH MONITOR MAKER 

3. ADDED TAH 7 W|TH POP-Bl «80 ROUTINES * PAl10 
4i RENAMED LIBRARY riLES 

>• ADDED LEVELCiHEMi SYSTATiMEH TO MONITOR DOCUMENTATION 
», ADDED OPriLEiUFILCiPUEASE TO SUPPORT CUSPS 
7, ADDED PAKLOD > UTILITY DISK PACK LOADER 

CHANGED FROM VERSION V406 <>00) 01 JUN 69 TO V«07 (.00} 30 JUN «9 
TAPE 1. REMOVED nON|IR,OPR BiCAUSE RUNNING OUT OF ROOM 
TAPE 6, ADDED HON|TR,OPR 



END Df FILE TABLtiTXT 



"laMTR.OPS" 
MOi^lITOR AiSEMBUY ASlC U04Q I-mSTRUCT Ini.S 



TOM HASTnGS/T|./R*P/Pf C 1^3 JUt IvyH 



MONlTR|OPR«02 

PACE eei 

CHANGES LISTED 1: OHOEH MOST KECENT FIRST 
FIRST VERSION I? -IHICH CHAMGt aPPEAREU IkIUL St PJT ON EVERY UINE 

SU CHANUEu, 

CHAISE FKQM uEKSlJ'J vai5<-<)l) TO VERSION veil6 (-82) Z6 JUL 70 
1.5,2 AODED -tJH To GET ON THE AJH FROM MAGTAPE 
'i.e.2i2.P,3,2,C,^ ADUEO Hqui TO MAKE MONITOR FRo« MACTAPE 
•5,1.2 ADDED 'Ort TO ASSEMBLE EMTIHE nONITQR OH OSK WITH ONE CCL FILE 
6il AaOEU Ci<ASH PROCEOyRt TO WHITE ON DISK wjTh BOOTS 
CNAMGE F«OH VERSIJN V014(-Ol> TO VERSION V01S(l!i) 
CHANGE FROM VERSIUi Vl?i3(-fli;) TO VERSION VUl^l-Zl) 12 APR 70 

Convert to leveu d, 

CHANGE From VERSION V^12(-UK) TO VERSION VI«13l»eH) 13 MAR TB 

«,2.5 SAVE (OJMP) PROCEDURE CqRRECTEO WJTh ADDITION OF LINE 
"I4ei" BEFORE 0i4S45S SAV 

CHANGES FRO" VERSIOM V01Li(-P0J TO VERSION V011(-00> 6 JAN 70 

1.3.3 r^EVlSEb REFRESH PpOCEOURE 

3.1.9,1 DESClPTION OF HQNITOR SOURCES 

CHANGES FROM VERSION V007(-0e> TO VERSION Vai0(-B0) 30 JUN 69 

». ho»/ TO Save a monitor crash ano dump symbolically with filodt 

ADDED THIS NEW SECTION 



MONITR,OPR<?02 

PACE teez 



QUICK INCtX TO MOMTDS.OPR 

C ]<S INDICATE STEPS NEEDED FOR DISK SYSTEMS [ie/*S!D AND X0/&a| 
k.HICH ARt rIOT DEEDED FOR NQN-DISK SYSTEMS (17!/*ZH) , 

1, MOW TO GET ON THE AIR WITH AN EXISTING TIMt SHARING MONITOR OH A OtCTAPE 

1.0 REQUIRED COMPONENTS 

1.2 MONITOR ONCE ONLY OPERATOR DIALOG 

IX, Z MONITOR FILE STRUCTURE DEFINITION A^O (REFRESH DIALOG (DISK SYSTEMS)] 

V15 CI, 4 COPY cgSPS FROM DECTAPE TO LEVEL OISk USING FILEX] 

cQR- 
VX» :l,5 COPY CUSPS FROM MAGTAPE TO LEVEL DISK USING FAlLCOJ 

2. HOW TO HAKE A MONITOR FOR YOUR CONFIGURATION FROM LIBRARY FILE 
2»e REOUIHED COMPONENTS 

2,8,1 IF MONITOR SOURCES ON OECTaPE 

Vi» 2.^,2 IF MONITOR SOURCE ON MAGTAPE 

Vl» a.i'.J 50PV MONITOR SOURCES FROM mAOJAPE TO LEVEL C OR DJSK 

Vl» 2,0,4 BRlEr (AND FASTER) INSTRUCTIONS TO 00 SECTIONS 

2, It 2,2> 2,3. 2.4 UNDER A LE'VEL C OR LEVEL OISK MONITOR, 

2.1 DEFINE CONriGURATlON FILE USING MONcEN 

2.2 ASSEHSte f*C0NFlC*COHM0N (ANO S*CONriG*COMM003 USING MACRO 

2.3 LOAD COMMON CANO C0MMO09 WITH MONITOR LIBRARY PILE USING LOADER 

2.4 SAVE MONITOR USING MONITOR SAVE COMMAND 



K0N1T«,0PH'.8I2 
PACE BB3 

3« hC« to AEsLMbUE f<0NiTOR SOURCES, CHEATl LlBRARV TILE, 

10 »'<aDU(k. A i\(a^ MOM TOR 

.<..-* f^Ei.UIt't.iJ COMPONr^TS 

>"*.! ASSEMBLE SOURCES USIMG lACHQ 

ill, 1-3, 1,6 ASSEMBLE ALL SOURCES AUTOMATICALLY WITH CCL FILES 

3.3,7 ASSErlHLt EACH SOURCE BY H/iND 

3.2 CVHl't NtLOCATARLE BINARIES TO MAKE LIBRARY FILE USING PIP 

3.3 LOAD iriMTOR USjuC LOADEH 

3.4 jAVE iO.«ITCR ySiNt MONITOR SAVE COMfA.-JU 



<• -iO« TO »^A«.L OUT PATCHES TO YOUR MONITOR 

A,,' tELUHLIj COMPONENTS 

4.1 PATC>.r-)G I^ITh EXEC ODT IN USER MODE WHIlE TIME SHARING 

4.2 PATCHldU HITM EXEC DDT STAND-ALONE EXEC MODE 

4.3 PATCHI.-G CONVENTIONS 

5. HOW TO ASSEMbLE MONITOR SUPPORT CUSPS 

*• ^OH TO SAVE A MONITOR CRASH AND DUMP SYMBOLICALLY WITH FIUODT 



M0NlTR|OpR-B12 

PAGE am 



1, HOW TO GtT UN THE AIR WITH AN E.XISTING Tl^t SHARING 
hONITOR cm a OECTAPE, cusps on OtCTAPE C0« MAGTAPE: 

1,0 COMPONENTS REOUIRtO 

1.0,;' A SAV COPY OF THE MONITOR O^i A DtcTAPE 

1,0,1 A CLtARtD MACHINE CANO A OISKJ 

1.0,? "16K COR 32K OR 48K] TENQmP" ON PAPER TAPE (MAT8E NEEDED) 

V17 iF CJSPS AND MONITOR bgppORT CUSPS ARE QN UECTAPEt 

Vl7 1.0.3.1- MONITOR SUPPORT CUSP TAPE <TaPE #8) 

Vl7 l,ii!,3.1 CuSP SAV FILES 1 

Vl7 1,3.3.2 CUSP SAV FILES 2 

Vl7 l.t),3.3 MONITOR SUPPORT CUSPS (TAPE #9) 

Vl7 l,»3,3.4 TEST PROGRAMS (TAPE «1Z) 

V17 1.0.3,5 LEVEL CUSp TAPE<TAPE #13) 

Vl7 1,0,3.6 MORE MONITOR TEST PROGRAMS (T*PE «17) 

Vl7 CIF CUSPS AND MONITOR SUPPORT CUSPS ARE ON MAGTAPEI 

V17 1.0.4,i- FAJlCD.SAV ON A DECTAPE(Y0UB MONITOR TAPE TAPE * 1) 

Vl7 t,a.«.l CUSPS ON A MAGTAPE (LEVEL C FORMAT) 

Vl7 l.a.4.2 MONITOR SUPPORT CUSPS ON A MaGTAPECLEVEL C FORMAT) 

Vl7 ] 



MONItR,OPR«02 
PACE fi05 



1,1 i-lt.n-l>. Y01.R "^OMTCR fROH OECTAPE USING TENQMP 

Vi^' iRlEF iTf:P BV ,)TLP OPEfiATDR INSTRUCTIONS TO LOAD HONITQR FROM 
WIS' ;>ECT*PE ..IT-' Tt.'.OMP, TmESE aRE BRIEF E'JOUCm TO BE PLACEDON ThE 
COi-.PLTtt, CO^i-Jl-t, TWE \EXT FEW PAGES DESCRIBE THIS PROCESS 

IN m;,RE ..tTAIU, 

Vlkl 1. fUT OMTJK TAPE ON QECTaPE UNIT ^ <OIAlED AS 8) 

Vllf i. ^Vi>>' STtih UOwNCCONSCLt SWITCH) 

VlU 3. CUS^ i^tSf T LiO"<N(CClNSOUE SWITCH) 

VlH ". FUS-i NOx, EX ^'fcM UP<CON$0LE SWITCH) 

Vli^ i. FUi< lE'-'i.'^Y PARITY ijPtCONSOUE Sw I TCH ) (u^LESS TOU HAVE HAD MEM 

Vl«) PR.OnLEnS -^KCENTLY) 

Via 6. PUT I..MIT U', WRITE lOCK(DECTAPE UNIT SwITCH) 

VIH 7. SET JEaD-J , utVlCE TO 32a<SWlTCHES 4i»i ANU 7 DOWN, REST UP 

VIP ^^ -'.^I'jTr J4Nct PA^EL JUST ABOVE UlGITAU PDP-IB NAME pCaTE ON 

VlH CO-s'l-E) 

Vl«; =i. PUbH «Eal.-I:m(CO'^SOLE iWITCrt) 

Vli! 9. iMT 2 S-^JULD MOVE, IF IT DOES, GO ON TO STEP 10 BELOW 

Vlt! ir pr jUST COUNTS UP, LOAD TENDmP 

vi«; FROM PAPfH Tape reaoe«i 

Vlki A. P.jSH bTOP 

Vl" B. PUSH i-ESET 

Vlk) c. PUT TfsDMF TAPE IN READER 

Vll! ,.. S£T REAP-IN SWITCHES TO XK?<SWITCHES S AND V OOMN ON MAINT- 

Vl" EfANCt TAfvEu JJST ABOVE DICITAI. POP«10 NaME>LATE ON CONSOLE) 

Vll« t. PUSH iEaD-IN 

Vl") F, PAPER TARE ShOULO MQVE 

VlB G. llWf -ILL RESPOND WITH CARRIAGE RETURN WHEN LOADED IN 

V10 h, READ .IIHECTORY BY TyPINGI 

Vlf <ALT-mOOE> 

VliJ 1^, THE TE^3^•P ON FR0^T Of TAPE AUTOMATICALLY REAOS IN DIHECTORV 

VIO li, LIST ThE aiRECTORY (UNNECESSARY IF YOU KNOW ITS CONTENTS) BY TYPING 

THE FOLLOWING ON THE CONSOLE TELETYPE (CTY)J 

Vl" F<ALT-M0Ot> 

V15 12, TYPE XXXiOM SAV<CR> TO LOAD FILE XXXMQN SAV. THE DECTAPE 

Vt5 klLL SPI, ANO START UP THE MONITOR, TEnDMP WILL TYPE A BELL 

Vis IF IT CAi <0T FIND THE FILE TYPED IN, 

Vie li, THE ^OMTOK »(JLL PRINT OUT ITS NAME, DATE, AND VERSION NUMBER. 

V10 THE! IT .ILL ASK FOR TODAY'S DATE, TYPE IT IN AS MM-OO-YY 

VliJ F0LL3x'£D BY A CARRIAGE RETURN, IF THE MONITOR DISCOVERS 

Via SY-JTAX En^OR, IT WILL REPEAT QUESTION, 

VliJ 14, THEN The MONITOR WILL ASK FOR THE TIME oF DAY, TYPE IT IN AS 

yiS ... "/^"^S °'''^ 84-HOUR TIME HHMH FOLLOWED BY A CARRIAGE RETURN. 

Vl*> IS, -ONITOR is READY TO TIME SHARE, * 

V10 THE pROGfAM COUNTER LIGHTS On'THE CONSOlE Will BE KTHE NULL 

Via jOci) AN'O ACCUMULATOR U WILL COUNT BY ONES. °t- *>' «• "WLL 

Vl» 16, PUSk^ NXW SWITCH DOWN (UNLESS YOU WISH ThE MqnITOR TO ATTEMPT 

VliJ TO SECOVh^ AUTOMATICALLY), 



PAGE aZi 

EXPlANATIUw of iNSTHUCTIOijS TO RtAO-lN YOUH -^Ol^ITOR "ITH TENDMP, 
YOU HAVE dEEN PROVIOEO "ITh A MOMITOR ^kIQH maS pEE^ flUlLT 
FOR AND TtSTEO ON YOUH HACHlNt, (Nt"l MAC'^lNES ONLY), THIS 
MONITOR IS O'] A DECTaPE LASELtO "YOUR ^<PMIToR••, TO UOaD 
THIS MONlTaRl 

1.1.1 HOi'-«T THIS TAPE ON 0£CTAP£ ORIVE 3 (MEf£HRED TO IN 
OCTAL AS DTAii - IN ADDRESSING THIS ORlVE THROUGH 
THE TELETYPE, IT iJlLL ALWAYS BE CaULED DTaB AL- 
THOUGH THE ORIVE is OIALta TO »), 

NOTEl NO OTHER DRIVE SMOUlO BE OrALEO TO 8, 

1.1.2 ASSUME THAT TENUmP HAS BEEiM WRITTEN ON BLOCKS t> 

DW 




ICHES 

•^ * ri fs'iu / i.nji«<!i (isuMun rMH I riji»m.tj i^i aNU ALU 

THE REST UP (TOP PART PUSHED INMoTA fJEVICE COO£«320), 

1.1,3 ON The LOHER UEf'T SIOE OF THE CONSOLE IS A ROCkER 

SWITCH LaBELEO NXM STOPi TURN OFF THIS SWITCH (FAR 
END OOWN), PRESS THE FOLLOWING ROCKER SWITCHES, LOCATEp 
ON THE LOWER PANEL OF THE CONSO|.t ON THE LEFT-HAND SIDE, 
IN THE ORDER GIVEN, 

STOP RESET READ JN 

DECTAPE UNIT i! SHOULD MOVE, IF PROGRAM COUNTER LIGHTS 
(TOP ROW ON RIGHT HAND SIDE OF CONSOLE) START TO COUNT 
UP, THERE WAS NO TENDMP ON FRONT of TAPE 
(USE COPV CUSP /t SWITCH OR PJP /U SWITCH), SO PUSH 
RESET TO STOP THE RUNAWAY TAPE ANO PROCEED TO STEP 
1.1,3,1, OTHERWISE THE OECTAPE WILL READ JN THE LOADER 
PROGRAM TENDMP, WHEN FINISHED, ThE TaPE WILL STOP, 
AND THE TELETYPE WRL MAKE AN AUDIBLE CLICK (PROVIOEO 
JT WAS TURNED ONJ, THEN PROCEED To STEP 1,1,4 

1.1,3.1 ON THE MAINTENANCE PANEL JUST ABOvE THE DIGITAL 

PDP"10 NAMEPLATE IS A ROW OF SWITCHES NUMBERED FROM 3 
THROUGH 9, SET SWITCHES 6 AND 9 oOWNt SET ALL THE REST 
UP (PTR DEVICE CoDE»104», 
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1.1.3.2 LOaO into the paper TAPE READER ThE TAPE 

LAdtUEO "TENOMP", INCLUOED IN roUR SOFTWARE PACKAGE, 
PPfSS THE FOULOWJNG ROCKER SWITCHES. LOCATED DM THE 
LO'tH PORTION OF THE CONSOLE ON THE LEFTHAND SlOEi 
IN THE ORDER GIVE.M, 

STOP RESET READ IN 

THE PAPER TAPE WILL READ AND LOAD THE LOADER PROGRAM 
TE.UMP, WHEN FiNISHEDi THE TAPE WiLt STOP, AND THE 
TELETYPE WILL MAKE AN AUDIBLE CLICKi 

! JTE. A i^RITtUP OF TtNDMP IS INCLUDED IN THI? PACKAGE, 

1.1.4 »'HE.N THE CONSOLE TELETYPE RESPONDS WITH A CLICKi 
TYPL IN 

■ <ALT.»MoOE> 

i^OTE- ON MODEL 37 TELETYPES, THE ALTMDOE KEY IS LABELED 
PREFIX, 

OECTAPE a (DUlEO S) will spin FOR A FEW SECONDS, AND THE 
OlhECTOHY WILL BE READ INTO CORE, WHEN IT HAS STOPPED, 

F <AlT«M0DE> 

<"F" FOR FILE NAMES) 

THt UlHtCTORY OF THE TAPE WILL BE PRINTED. 

1.1.5 IN This DIRECTORY LISTING WILL APPEAR THE NAME OF 
YOL-H MONITOHi IN THE FORM 

XXXMON SAV 

1.HEHE THE FIRST THREE LETTERS (XXxJ ARE AN ATTEMPT 
IS^?^??^???! ^O"" COMPANY'S NAME (E.G., DECMQN 8*V) , 
ll.f-r}t IS'?T^*2^ {FOLLOWED BY A CARRIAGE RETURN*, " 
EXALTLY AS IT APPEaRs ON THE LISTING. ON THE CONSOLE 
TELETYPE, (DO NOT SEPARATE NAME FROM EXTENSION WITH 
iuf'-2i°?iL I*^'* ACTION CAUSES DEcTAPE B TO SPIN AS 
THE MONITOR IS HEAD AND LOADED, TENDMPWIU RESPOND WITH 
A 6ELL IF IT CANNOT FIND THE FILE OR GETS A PARITY 
ERROR WHILE READING, -'•"•tt 
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l.Z HONJTOR ONCE ON(,Y OPERATOR DIALOG 

1.2.1 THE MONITOR wau REQUEST THE DATE AND TIME, 

TYPE TOOAY'S DATE AS ABOVE 

MM»UO-yy<CR> (MM » MONTHI DD « D*YJ YY « YEARi 

E.G., 12-J0-6b) (<CH> IS A CAHRUSE 

RETURN) 

TYPE A ««DIGIT Time 

TTTT (TTTT • TIME IN 24-hOUR FOHMATJ 

E.G., 1439 » 2I35"PM) 

SEE NOTE BEtOM 

IF AFTER PERFORMING STEP 1,1,5, THE OPERATOR IS NOT 
ASKED BY THE MONITOR FOR DATE AND TIMEI 

VIS (B) CHECK THAT YOU PUT NXM STOP UP (FRONT), IF YOU 010 

Vl5 NOTi PUT IT UP (BACK SIDE DOWN). THEN PUSH CONTINUE 

VJ19 AND CO ON TO STEP 1,2.2, 

(1) SET THE PROSRAM COUNTER SWITCHES TO B0014a(e), 

(2) PRESS STOP RESET START (IN THAT ORDER), 

(3) RESPOND TO D«TE AND TIME QUERIES. 

NOTE- THE OATI AND TlHE RESPONSES MUST BE TERMINATED BY A 

CARRIAGE RETURN UNLESS YOURS IS A le-iZ SWAPPING SYSTEM 
OR A te/4> SYSTEM WITH DISK, IN EITHER OF THESE CASES, 
YOU Wltl, HANT TO GO THROUGH THE COHRLETE INITIALIZA- 
TION DIALOGUE IN ORDER TO DEFINE YOUR FILE STRUCTURE(S) 
ANO "REFRESH" (INITIALIZE THE FILE STrU(;TURE<S) OF) THE 
OlSK(S)i THE COMPLETE DIALOGUE IS ENABLED BY TYPING 
ALTMOOE INSTEAD OF A CARRIAGE RETURN AFTER THE FOUR DIGITS 
OF TIME, 



MOMTH,OPR-B2 
PAG£ 209 

i.y.,-:- ir Yiiu.< systek contains a disk siic" that you typed 

ALT lUJi AFTtH TlME-OF-UAY, CO TO STEP l.J, OTHtRWJSE 
(Y!J TYPea A CARRIAGE RETURN), YOmR MONITOR JS 
AL-t-AuY RUf.M'Ja, 

IT lb aOVISaHlE TO Run the system with the NXM STOP SWITCH 
ro... so THAT THE HONJTOR WItL STOP If IT TRIES To REFERENCE 
r.O.-tXISTENT MEMORY (OH A MEMORY BECOMES INOPERATIVE), 
nOutVER THE MONITOR vJlLL TRY TO RECOVER FROM SUCH A PROBLEM 
aS oi.ST IT CA\., IF THE NXm SWITCH IS NOT DOWN OR 
ir Tr,E OPERATOR PUSHES CONTINUE AFTER A MEMORY STOP 
CA;.i>f.(J ay A NON-EXISTANT MEMORY REFERENCE, USU*l.LY 
[■"lY II.- t JOB «IL|. BE AFFECTED (VERY LKEUY IF NO PPS IN 
f-Ri ii<E5S) AND THE USER WIuu RECEIVE AN "TERROR IN JOB" 
■Xi AT EXEC NNMNNM UUO AT USER MmMMMM , 

IT IS ADVISABLE TO RUN WITH PAR STOP SWITCH UP »NEAR SIDE 
LP) I kaThER Than oo^n since maCHInE ""ILU RUN ABOUT 10 

Vis PESUL..T FASTES, IF A MEMORY PARITY tRf«ON OCCURS, THE 

Vl5 MOMTOft WILL USUALLY BE ABLE TO RECOVER. THE MONITOR 

Vis .III halt IF the parity erhor occurred while a pj was 

V1S> l\ f'SOGRESS OR THE MACHINE WAS IN EXEC MODE SINCE THIS 

V15> IS JIFFICULT TO RECOVER FROM RELIaBLT. IF THE ERROR 

V15 t'CCUMSED IN USER MODE. THE MONITOR SWEEPS THROUSH ALL OF 

VIS" CCht., IF IT FINOS EXACTLY ONE PARITY ERROR AGAIN (USUAL) 

VIS IT STOPS THE JOB AND PRINTS AN ERROR MESSAGE ON THE 

Vis i.SFHS CONSOLE aF'TER ATTEMPTING TO FIX THE ERROR BY 

VIS RESTQHIN(i THE VALUE IT READ OUT OF MEMORY, JF NO 

Vis ER'U-^S OCCUR OURT'lG THE SWEEP, IT IS COUNTED AS A 

VIS SPlRIOuS ERROR AND THE CURRENT USeR CONTINUES. IF 

VIS f.Oi-.f. Than 0\E EHROR OCCURS, the MqNIToR HALTS SINCE 

Vis A :.IuESPREAD MEMORY PROBLEM IS LIkEL*. A COUNT OF 

Vis jm .jUmBER of parity ERRORS IS KEpT AlONC WITH THE 

VIS LOCATION OF THE LAST ERROR (SEE GeTTAB UUQ) , 

&Y StTTlNG THE ADDRESS SWITCHES (LOCATED IN 

THt UPPER ROW OF SWITCHES, ON THE RIGHT SIDE OF THE 

COi aOLE) TO 2ER0, THE USER CAN OBSERVE THE NULL JOB 

VIS COuniNG, EVERY TIME THE NULL JOB IS STARTED UR AFTER 

Vis ANOTHER JOB Has been RUNNINGi AC IS RESET TO 2ER0. 

VIS BY "ATCHING AC I? COUNT, AN ESTIMATE OF NULL TIME BURTS 

VlS CA ME ESTIMATED, 



PACE tslZ 
1.2.3 REMOVE The hO.MTOR TaPE FRo« ;3RIVe QTa« IlhO MOUNT ON 

THt si.tti DRIVE The Tape in you« package labeled 

"Clip SAV FILES", 

TVhE tC (HCLO DOw\ The CTRL KEY "hILE STRIKING C) , 
Tk»t lOiMlTOR i<ILL RESPQl-iO ViITh THL tCHQ "'C" AND START 
a kLa lInE wiTH A "," 
TNE> TYPE 

.ASSIGN iiTA,' <CS> THIS IfJPOPMS THE MONITOR THAT 
THE CUSP TAPE IS ON OECTaPE i/ 
WHERE IT WIUL «ESIOe, 



1.2,4 bp-uE YOURS IS A fjQUDISK SYSTEM, yOU ARE FINISHED AND 
MAY PROCEED To USE YDUR TlME-SHARlKG P^P-ie SYSTEM. 
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1.3 'O'ilTOS I3K FILE STRUCTURE DEFIMJTION AND REFRESH OIAUOC (DISK SYSTEMS ONLY) 

1.3a IP', 1 HECEIVING AN AUTMOOE FOULOWlMC TYPEIN OF THE 
TTc-OF-OAY, YOUR MOmITOR wIUl. TYPE A SUMMARY OF 
THr I/O CONFICU«ATia.\ FOR -HICH |T WAS BUIUT, AND 
k.Ii,L PROCEED TO ASK FOH THE OPERATOR'S CONSOLE NAME, 
TMe JEVlCE 1.HICH YOU SPECIFY WILU BECOME THE OnE TO 
viJlCH f^ESSAGES FOR LOGICAL DEVICE "OPR" WILL BE SENT, 
A -tCOMMENDEU RtSPONSE T" THIS QUESTION IS 

lTY <CH> (<CR> is a CARRIAGE RETURN) 

1.3.2 nExI, YOU l«ILt BE GIVEN THE OPPORTUNITY TO RETAIN 
VI* I'^ CORE THREE OPTIONAL MONITOR CO-PQNENTS CALLED MOVIE, 5YSMAK, 

^1* *■"' EXEC DOT, These are useful for examining the current MONITOR, 

FOS CREATING ME" MONITORS, AND FOR DEBUGGING THt CURRENT MONITOR, 

fiEii'tcTivELvj They are usually nqt retained, 

A ftbPONSL CF CARRIAGE RETURN WILL DELETE THESE ROUTINES 
A'^'i ^AKE the space they OCCUPY AVAILABLE AS USER CORE, 

VI* Y0.-1 A.MSWERS TO THESE THREE QUESTIONS >tlll DETERMINE THE 

FP.AL SIZE OF THE MONITOR (THIS Sl2E IS TYPED AT THE 
EMf OF THE ONCE Q^MLY DIALOG, 

Vl« 1.3.3 NEXT YOU MUST SET UP THE DISK FILE STRUCTURE, FOR 
VI* DETAILS SEE LEVtLD.MEM SECT, 4,2, AND OSK016,MEM 

Vl* SECT, 4,2 AND 4,3. 

1.3.4 IT IS COMMON PRACTICE TO INCLUDE T^E ACCESS PROTECTION 
FEATURE CALLED LOGIN IN ALL SYSTEMS CONTAINING 6|SkS, 

VI* THE LOGIN MECHANISM REQUIRES THE PRESENCE OF THREE FILES 

ON THE UISKI THE LOGIN CUSP (LOGIN, SAV) AND THE SYSTEM 

VI* ACCOUNTING FILES (ACCT.SYS AND AUxACC.SYS). ALTHOUGH YOUR 

MOr.ITOH IS NOW RUNNING, THESE REQUIRED FILES ARE MISSING 
FROM THE NEWLY REFRESHED DISK, FqR THIS REASON! AN AUTO- 
MATIC LOGIN IS ALLOWED FOR THE FIRST USER TO TYPE THE L06IN 
COr^lANO AFTER THE DISK HAS BEEN REFRESHED, 

TYf't 

UJGIN <CR> 
THE SYSTEM RESPONDS WITH 

JOUI <YOUR MONITOR NAME> 

YOi. ARE NOW LOGGED IN UNUER THE PRIVILEGED FaIlSAFE 
Vl* MU^aERS 1.2 SO THAT YOU MAY WRITE ON ANY DISK AREA 

Vis «ITH ANY CUSP. 

SET NXM SWITCH DOWN, MEM PARITY Up, AND ADDRESS SWITCHES 
TO J, SEE SECTION 1,2,2 FOR DISCUSSION OF THESE SWITCHES 
AND WHEN IT IS ADVISABLE TO SET TmEM DIFFERENTLY, 
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V16 S*V FILES, S£E FILEX.MEM POH A COMPLETE DESCRIPTION. THE 

1.4 COPY CUSPS FROM DECTAPE TO LEVEL D DISK USING FILEX 

Vl» (SKIP TO BtCTJON 1,5 FOR MAGTAPE TO DISK COPYING, IF 

V15 YOU RECEIVED THE CUSPS ON MAGTAPE IN F*ILCD OR FaILSa FORHaT) 

Vi5 FILEX IS A UTILTIY CUSP LIKE HIP WHICH COPIES ULES FHOM 

Vl5 CECTAPE to disk and back I^j AN EFFICIENT MANNER, IT 

Vt5 ALSO HAS A NUMBER OF OTHER FEATURES SUCH AS CONVERSION TO 

V15 AND FROM PDP-6 DECTAPt FORMAT AND EXPANSION Of iERO'COMPRESSED 

Vl* SAV FILES, SEE FILEX, MEM FOR A COMPLETE DESCRIPTION, ThE 

Vl5 FOLLOWING INSTRUCTIONS mILL SUFFICE FOR COPYING THE CUSPS, 

V1& AFTER THE UISK FILE STRUCTURE(S) HAVE BEEN REfRESHEO, THE 

V15 FIRST USER TO TYPE LOGIN Is LOGGED IN As 1,2 (THE PRIVILEGED 

Vl$ FAILSAFE NUMBERS), 

Vl5 1.4,1 MOUNT THE MONITOR SUPPORT CUSP WHICH CONTAINS FlLEX.SAV 
V15 (TAPE #6) ON DTAa, 
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Vl5 l.t.i TYi L 

Vl!> .iiblti. OTA. 

Vis 

V15 tTA ASSIGNED 
VIS 

VIS 

Vis .Hi, . OTAK FILFX 13 

Vl5 

VIS •nf^B![l,4 3<lS5>/5»0TAKI«.SAV,»,SMR 

V15 

VIS 

VI* i-rif-iK LSkB is uHiHi YOU H*f-T YOUR CUSpS STOReO BECAUSE 

Vl* IT IS « UAHGE (BgT POSSIBLY SLOwiR) FRE STRUCTURE THAN DSKA, 

V15 IT UA'. tJE HfFEHtNCEO LATER 6V USERS SIMPLY 

VIS AS ULV SYS, THE /O SWITCH STANDS FOR OUICK AND CAUSES 

Vis FILtX TO MAKE JUST O^JE PASS OVER THE QECTAPE ANQ 

V15 COFY IT QUICKLY O'MTO THE DISK, ThERE UPON IT SORTS THE 

vis "JAv A!.D SHfi FILES a:'IO SETS THE PROTECTION TO 15S, THE 

VIS 1 i3 A tLAG TO LOGOUT TO PRESERVE THIS FJLE, THE 5S 

Vis ALL'J-o USER'S IN OTHER PROJECTS ThAM PROJECT 1 TO REAO 

vlf TMt ciJiP FILES. THIS IS NECESSARY ONLY IF THE DEFAULT 

VIS riLE ^^UTECTIou JS LEFT AT ITS VALUE OF 057 AS OISTRIBUTEO 

vis BY JH,nAL, THE CORE ARGUMENT OF lid SPEEDS UP THE TAPE 

VIS cOfY LJPtRATIO'^, A LARGE CORE ARGUMENT HAY BE USED, IF 

Vis ro AHGtMENT IS PRESENT. FILEX WILL EXPAND ITSELF TO A 

Vis KFASO-iAbLE SI^E FOR USE UNDER REGULAR TIME SHARING 

Vis CluCirt LESS THAN IB), 

Vis FILEX -III RESPOND iJlTH AN » i,'HEN IT IS THROUGH. JUST 

VIS lIkE P|H, MOUNT THE FOLLOkING TAPES IN ORDER AND TYPE 

Vis THt COMMAND STRING iNUICATEUI 

VIS CUS>' SaV FILES 1 

• QS<b;ci.'l3<155>/0*0TAHI»,» 
V15 cu<3p SaV files 2 

• DSi\BlC1.4Kl55>/Q«.0TAB|«,» 
vis h<0-.ITQR SUPPORT CuSPS tTAPt »») 

• 0Si<h![l,4D<155>/g*0TAIi!|«,SAV,«,SwH 
Vis TEST PROGRAMS (TAPE #12J 

•DSKB:i:a,43<155>/a«-0TAii!l«,SCP,«,SAV,«.HCH,«,SHR 
Vis INTERIM LEVEL CUSP TVkPE (TAPE «l3) 

• DSKo:C1.4K155>/0»0TAei»,SAV,»,SHR 
VIS mORL MOrvlTOH TEST PROGRAMS (TAPE #17) 

• DSK3:Cl,4K155>/Q»0TAi!l|«,SCP,»,SAV.»,SHR 
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1,5 COPY CUSPS AiO MOMTOH SUPPORT CUSPS FRqI IaGTAPE TO LEVEL OJSK USING FAILCD 

1.5,1 IF YUUR POP-l." CONFIGUHATIUrj INCLUDES DISK ANO MAGTAPE 

VOb wJlL probably have «EcEIVEu YOUR HONITOR ANO CUSP SOFTWARE 
Vl5 ON Two SEPARATE MAGNETIC TAPES IN FAlLCU FORMAT (IE LEVEL C 

V15 FAILSAFE FORMAT WHICH CAN HE SEAU BY A LEVEL C FAILSAFE 

V15 ' ONTO A LEVEL C OISK SYSTEM, OR C*^ 9E PEAQ BY FAILCD 
VIS ONTO A LEVEL D OISK SYSTEM,) MAC. RtL. SAVi AMU ShR FILES 

HAVt. ALL BEEN CULLECTEC TOGETHER PJ UFQ 10,7 On EACH TAPE, 

VlS THE FOLLOWING TABLE SHOWS THE DlFrERE^T VERSIONS OF 

Vl$ FAILSA CUSPSI 

Vl5 FAILSAFE TAPE TO DISK TO TAPE 

Vl» FAILSA. V16 C C C 

Vl5 FAILCO C D - 

V15 FAIUOC -DC 

VIS FAILSA, V27 D D 

VIS NOTEl IT IS SUGGESTED THAT EACH OLD CUSTOMER CHANGE 

VIS THE NAME OF THE LEVEL C FAILSAFE CUSP HE ALREADY HAS, 

VIS TO FAIuCCi TO DISTINGUISH IT FROM THE FAILSA BEING 

Vis OISTRiaUTEO Now WHICH IS LEVEL D TO ONLY, 
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].b,,; r;-n r CSrS fHi' MAGTAHt TO UtUtU D DISK 



aFT-:- -AvInS LOAQEt) THE. MQ-IToWi ^EfHESHED THE UISK AND 
Vl3 i'.'l J iATICAUUT uaGGED IN UNGES THL MlLSAfE ^lUMSfcHS 1,2 

(A- ut^i^RlalO n SECTION l,j ABOVF) MQIJNT OECTaPE CONTAINING 
(AIL."i..SAV 0.\ OtCTAPE DRIVE 2 AND T-IE CUSP MaGTAPE ON MAGTAPE 
.,^l<iK ... TVPE To THE MOMTOFiJ 

AS.Sl.,;.j KTA.^ FilLSA 

FOut..'^LU BY A CARRIAGE HLTU*<N, T At MOMTOB WIuL RESPOND 
: Ti._ A'-,S1G\£0 

("! .T-j-t TM4T THE TAPE AT THE LOAD POI^T. OS CINE AND 

.HiTt lOCKEQ - him; RtMOVEL) 

i'S^U.-j DSKB US.< 

■ ■'ifl :.SKfa IS YOUR LARGEST FILE STRUCTURE. 

(F-lLoJ WHITES ALL FILES Q\ UEVltE DSk)' 

T-^ : Typt TT THE MOMJTORI 
V13 =!_' _T4i FaIlCU 

MJLLJ'-tB 8Y A CARRIAGE RETURN, FAJLCO -.'ILL TVPEl 

Fc. htLPi type; /» 

* 

TYfi-a /H KILL Cause failsafe to print a list op switch 

LPHJi.a AND OPtWATING INSTRUCTIONS, YOU MAY <II5H TO 00 
T>.I^ AT SOME TIME bUT FOR NOW IT IS OMLY NECESSARY TO 
TYFt TmREE COH^<AN^S 

/H 

FOLL'MLO ay A CARHIAGE RETURN, ThIS WILL INrORM FAlU' 

SAft Tf'AT THE MAGTAPE IS RECORDED AT SCB BITS PER INCH, 

FAILSAFE '«ILL RtSPONO WJTh AN ASTERISK, 
Vl3 TV! 1 1 

Via /Gj ,7 

Vli FOLLO»itO BY CARRIAGE RETURN TO TElL PAILCD YOU WJSH 

Vl* TO JPEriATE ON THE 12,7 UEOS ONLY 
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Vl* IF Y,iu HAVE A UARCt E^VGUGh PISK (l t?Po2 aS "^O^f 

Vl* IT -ILL BE FASTER TO COPY ALL OT THE 1?,/ aBEA FSQm 

V16 r-'AGT«Pt TO 01S>< (SOUBCE A\D SAVE FILES), uO^ttMlH IF 

Vl6 rn. nA«t LI^ITEU SPACE. YQu '"ILL >^AVE TQ MAKE 6 PASSES 

vi6 ovt'< tme Failsafe tape in o^iir t- selectively copy 

VU> just The •,PE|.,».HGh,»,LO.,»,SAVnt,SHR.QPlP FIlES. 

V16 ir Yi.-.Li HAVE A LAR5E uISK, TYPti (cO-iPUTt« OUTPUT IS 

Vl6 uOiTEhLINED) 

Vl6 ••,» 

V16 

V16 • 

Vl6 

V16 IF YCiU HAVE A SMALL DlSKi TYPEI 

V16 ••,'<EL.»HGH,»,LOW,»,SAV,»,SHR,aPlP 

V16 

Vl6 • 

V16 

V16 

AFTEH FAILCD *HAS finished, TYPEI 

VI* <CCNTHOL>C 

V16 .Run QSK PIPCl(«i7] 
V16 

VlP •0eKBICl|4]/X/B*DSKI»,RtL,»,hGH,»,U0W»»«SAV|»,SMR,OPIP 

Vli " 

V16 • 
Vl6 

Vl« YOU MAY WISH TO PUT THE FORTRAN LIBRARY ON A FASTER FILE 

V16 STRUCTURE THAN DSKB, TO DO THIS, TYPEI 

Vt« •0SKAIC1|4]/X/B*0SKILIB*B,REL.DDT.RE;L 

Vt6 SOT&I ir DSKB IS LARGE ENOUGH AND OSka APPEARS BEFORE 

V16 OSKd IN THE SYS SEARCH UJSTi YOU MAY KEEP DUPLICATE COPIES 

Vl« OF THE UIBRARY On OSkB I IN CASE DsKA SHOULD GO DOWN), 
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v'l* l.i,3 COi Y KOMTJ=* 5uPp3RT CUSPS fRQM MjGTApE TO DISK 

>'l* ■'fi'T OISMOU-.T THE CUSP MAGTAPE AN". MDU^T THE MONJTOR 

"it IXK^HMATjaJ:' ^'^' '''''• "'^ ^"'''^ ^'■'•^ f°« «0«E 

^/l-* T,-t.'< TYPE TO THE MOwiTORl 

^l*- .-i'-t 0TA2 F4JI.C0 

«16 

Vl" fO- ^EuP| type; /^ 

vl6 . _■ 

v'16 B/- 

Vl6 

Vl<> ii/M.,7 

Vl6 

"•I* I'' TOu Have a large OISK, TVPEI 

'-■l* If TiU HAVL A SMALL DISK, TVPEI 

• •.i>VS,»,SAV,».SHN,»,HGH 

1/16 > 

n6 

Vl« AFTtK FAILC'J 4Ab FINISHED, TYPEI 

Vl? <C.;'lTHOL>C 

Vl6 .9 PIP 
Vl6 

"^^ •0''<BiCl,4J/X/(3»OSKI»,SYi,»,SAV,«.SiHR,«.HCH 

(/to 

V16 • 

V16 



^}° If" ^OL) ALREADY HAVE AM ACCT.SYS A\iD AUXACC.SYS ON Cl.43. 

VI* OMIT ..SYS IN ABOVE COMMAND STRING. YOU NOW 

Vlf ^^^t- «ESTOREiJ THE CUSP AREA EXCEPT FOR YOUR OWN ACCT.SYS, 

Vl* Afjri AUXACC.SYS ACCOUNTING FILES, "«• • i 



^1' ■'■0' RESTORE Y3UR ACCOUNTING FILES FROM DECTAPE OR DISK 

^1* *Hti<EVtR YOU ^AVE WRITTEN THEM, jF YQU ARE A NEU 

Vl^ CUSTOMER, YOU wiLL NEED TO CREATE THEM, TO DO This SEE 

^^* SECTIONS &,6,2 In lEVELD,MEM, SECTION 13,15 IN OSK016,MEM, 
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V16 1.5.1 HCtT-jHt YOUH ACCOU>.Tl-JG fluES 



ali-jG -.iTH TMf. Cusps an Accou-.Ti^r, fiut uccT,sy&) was 

LOADED •"ITH T4E rOLlOwING t'.TSIES: 

i, PtSiS-JUKQ 

V14 1 * CUS" 



FriojECT NO, 


P«OG 


1 


2 


1 


t 


IS) 


7 


7 


7 


6 


6 



OIST 

laa lUie nCMni 

YOU WILU PROBABLY wAnT To KUN THt CUSP REACT To ADO YOUf« 

CMi. NUMBERS AND CHANGE THe PASSWOsU FOR FAILSAFE (1|2) 

AND CUSP (1.4). YOU SHOOUQ ASSIGN PROJECT MUMSERS AND 

PROi.HAMIiER NUMBERS STARTING WITH H TO YOUR USERS. DIGITAL 

HAS RESERVED 1-10 FOR SPECIAL PURPOSES. YOU WILL ALSO NEtO 

TO "lAKE ADDITIONS TO THE DISK quOtA ADMINISTRATIVE FILE 

AUXACC.SYS, THIS IS ALSO DONE WITH REACT, SEE SOFTWARE 

NOTEBOOK, UEVELU.mEM SECTIOM i,5,2. 0SKiS16.MEM SECTION 13,15. 

THE AUXACC.SYS FIUE HAS QUOTAS FOB Cl.»3. C6,»3 . C7, »3, ClZi»] . ClBBi*] 

OF . RSKVD, l^ilinae FCFSi lIDVIlam LOGGED OUT ON DbKA.OSKB. AND OSKC, 



THE SOURCE FILES FOR ALL THE SYSTEM SOFTWARE HAVE BEEN 
SAVED WjTH FAILSAFE ON MAGNETIC TaPES IN THE FOLLOW- 
ING MANNERl 

ySEB AREA CONTENTS 

ON MONITOR MAGjAPEl 

li-,7 SOURCES, MONITOR ANQ MONITOR SUPPORT CUSPS 

DOCUMENTATION, SAV FILES 

ON CUSP MAGTAPEI 

1J,7 CUSP SOURCES *ND RELATED ,OPr FIuEs 

DOCUMENTATION, SAV FILES 

THESE FILES MAY BE ACCESSED BY LOGGING IN uNOER THE RELAT- 
ED NUMBER AND RESTORING THE UESJRED FILES WITH FAILCO, 
FILES MAY BE RESTORED EITHER COMPLETELY FOR A uSfR AREA 
OR INDIVIDUALLY. AFTER OOJNC THIS. IT IS RECOMMENDED 
YOU COPY THE FILES FROM DISK TO YqUR OWN DECTAPES FOR SAFE 
KEEPING WITH PIP, FOR THE MONITOR SOURCES, BE SURE TO 
Vl« COPY THEM IN THE PROPER ORDER TO MAKE 17 MONJToH SOURCE 

DECTAPES, SEE TABLE, TXT FOR A I.ISTING OF FILE NAMES FOR 
EACH DECTAPE, THE MONITOR ASSEMBLY I?<STHUCTI0NS ASSUME 
THAT THE MONITOR SOURCES ARE ON DECTAPES AND DESCRIBE HOW 
TO COPY THEM ONTO THE DJSK, IF YOU WISH TO SPEED UP THE 
ASSEMBLY PROCESS, 
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IK YCU HAVt A SI>iGtt BUR«ai-5HS DISK (HD-iai JT WUL NOT 
.'-wUu The co-tents Of the MIUSATE TAPt, SINCE IT IS 

Lvt^ NiECESSaHY to RESTof^E Alt TH£ SOURCE FIUES AT ONE 
Tl-i. TmIS SmTUlT NtlT BE AM ImCO-VEN lENCE , 

TO tic.-jTOHE ALL. UiePAtfV SOgKCES 

L.T r. uSER TV^)ES LOGIN 

jr.,. 3 43.451 Ti MONITOR SYSTEM ASSIGNS JOB NOi 

il ,7 USER GIVES PROJ.PROG NQS 

PASi^CittJi PASSWORD- OOES NOT PRINT 

ly 1 5 t-JuN-l'V TTVJ JOB IS LOGGED IN 

,Af HTA FAILiA LOGICAL NAME ' 

t'TA ASSIGNED FAILSA REQUIRED 

,«. KaIuSa 

FOr M„tP. TVPF! /M MESSAGE FROM FAILSAFE 

• .,• URST • TVPEO BY FAILSAFE, 

USER TYPES »,• TO RESTORE ALL 
1.IBSARY SOURCES 

Fo- HtLHi type: /h 

• AxlS,FA,ALPMI.f«-AC.4LPH0,MAC 

USER TYPES SAMES OF SELECTED 
FILES. ONLY THESE AR| RESTORED 
TO THE DISK IN USER AREA 10,7, 
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2, »0»i TO «Ai<l 4 MO'^n.lR F0» V^UK CO >IF 1 GUN^i 1 I J-j FMGf ul^HiRY FILE 

2.2.1 KtJUl^EO CQMPON'EKTS - IF MnMTOR SCa«Cf« 4«f: 0** CECTaPE: 

2,0,1,1 1 /4i:. MO»<lT."iK MAIMER TAPE [TC MA^K Irf/AiC OH IZ/bB SYSTtMj 
SPi JfJ.lftK -ilrjUiAt I6i< SPECIAL VA/i'l lOf^ITOR 

sp-a..,j2< t'lNiHAL -J^^ sPtriAt Vi'i? i^o^^itor 

Vt5 SPl'Jii.AdK MIMHAU 4*)K SPtcIAU li'/3J; MQ.MTOrt 

Vl5 12..,16K MJMIMAL STANiDAWQ IH/J? HONHCR 

V15 (NEEDtO TO MAKE f'.5NGEN,SVE) 

PIP.bVE STA.WAHQ 10/3iii plP 

r'.ACMa,5Vf STA^XiUARO ltf/5K MACi^O 

LOAJER.SVE STA.>JOARd liS/JB lOADF* 

MOM.E.\,SV£ CaKiFIGURATlO!.: Ct? INITIOS PROG ■ 

TO RUN UMDE'* 11C/J3 
Vl« &N##,REL KOWITOR uIBRARY BI^A^Y TO PRO" 

DUCE l«!/43 TIME SHARING SYSTEM 
CWHERt ## IS THE LOAD NUMBER OF THE 
mUlTIPROSRA'^MINg mOhj-DISK momtorj 

2, '',1.2 ASSEMBLY TAPE (TAPE »J) 

S,"AC SYMBOL EEFIn'ITI'^'- ^ILE ASSEMBLED 

WITH MOST OTHEH PILES 

2.3.1,3 sOr4lT0R SOURCE FILES (TAPE #4) 

COMMON, MAC COMMON OAJA STORAGE FOK MONITOR 

2.e.l.« l^fii MONITOR REL FILES CNOT NEeOEO FOR \i/M SYSTEM3 (TAPE «7> 

VI* 5S»#.R£L MONITOR LIBRARY BINARY TO PRODUCE 

la/SB TIME SHARING SYSTEM 
CWHERE ## IS THE LOAD NUMBER 
OF THE SWAPPING MONITOR] 

2.2.1.5 LEVEL MONITOR FILE SYSTEM SOURCES (TAPE #14) CNEEDED ONLY IF DISK SYSTEM] 

COMMOO.MAC COMMON DATA 8AS£ FOR DISK SYSTEMS 
CATQMP.MAC (OPTIONAL) CORE BLOCK DUMPER FOR DEBUGGING 

2,0.1,6 MONITOR SUPPOHT CUSP.SAV FILES 

2.0.1.7 C'lE HLANK OECJAPE 

2.0.1,8 3 OECTAPE QolVES (2 CAN HE USED, ALTHOUGH THE 
INSTRUCTIONS ARE WRITTEN FOR i yNITS) 

2.2.1.9 OPTIONAL " A LINE PRINTER 

2,0,1,118 OPTIONAL - A HuNNiNG TIME SHARING SYSTEM 

SKIP TO SECTION 2,1 IF SOURCES A^E O^ DECTAPE 
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Vl6 i..',i' KtiUISEO CO■^P0NtNTS - IF MONITOR SOUHcES ARE ON MAGTAPE 

V16 2, .2,1 A HUMMNG LEVEL C tJ OH < SEHJES) OR LEVEL 

Vl6 D (5 SEKIES) MONITOR 

V16 i, ,d,2 A MONITOR SOURCta MACTAPt (FAILCO FORMAT 

V16 IjFu li,Jy 

Vl6 ?.. .2,-5 A DtCTAPE WITH fAILCO.SAV ON IT IF THE HUNNING 

VX6 MONITOR IS A LtVEL MONITOR, NEW CUSTOMERS 

V17 hiLL FIND FAILCO.SAV ON TuE "YOUR MONITOR TAPE" 

V17 (TAPE #1). OTHEHi^ISE Tnt 

V16 LEVEL C FAILSA.SAV ALREADY ON THE CUSP WJUL 

V16 SUFFICE. THEN DO SECTION 2 . ? i 3 FOLLOWInGI 

V16 i.. ,7 COFY MONITOR SOURCES FROM MACTAPt TO LEVEL C OR DISK 

Vl* 2. ,^,1 IF YOU ARE RUNNING UNDER A LEVEL C DISK MONITOR 

Vl«> YOU MUSI AOO A PASSWORD KOR PROJECT, PROCRAMHER 

Vl* NUMBER tia,73, BE SURE Tfl USE LEyEL C (NOT DIS- 

V16 TRiaUTEU LEVEL REACT) biNCE YOU ARE RUNNING 

Vl6 UNUEH A LEVEL C MONITOR, ANY PASSWORD WILL 00, 

V16 IF YOU ARE RUNNING UNDER » LEVEL DISK MONlTORi 

V16 THE ACCT,SYS ANU AUXACC.SyS ADMINISTRATIVE FJUES 

VlO ALREAUY HAVE PASSWORD AND UISK QUOTAS RESPECTI VEUY 

Vl6 FOR CKW7J, THE PASSWORD IS DIST 

Vie> 2. ,i,2 LOGIN UNDER l«f7 

Vl6 2. ,i.i ASSIGN A MAGTAPEi BY TVPJmGI 

V16 .ASSIGN MTA FAIL!>A 

Vl6 

V16 MTA>. ASSIGNED 

V16 



Vl6 2.. ,3.4 MOUNT THE MONITOR FAILSAFE MAGTAPE ON THE UNIT 

V16 TYPED OUT BY THE MONITOR (EG MTA«), 

Vl6 2,. ,3,5 IF RUNNING UNDER LEVEL C» TYPEI 

V16 ,R FAILSA 
Vl6 

Vi* («htRE UILSa is level C FAILSA, not DISTRIBUTED LEVEL FAl^SA) 

Vl6 ELSE IF RUNNING UNDER LEVEL U, TYPEI 

V16 .ASSIGN OTA 

Vlb .. 

Vl6 0TA3 ASSIGNED 

V16 

V16 MOU^'T OECTAPE CONTAINING FAILCO.SAV ON IT 

V16 (TAPE »ll FOLLOWED BY| 

Vie ,RUN.' QTA3 FAILCU 
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V16 2. ,3,6 TVPt 

V16 ASSIG.\ D$KU OSK 

VI* kmEKE. USkS is Trit FILE ST;,UCTUSt OK WHICH YOU 

''I' HI3H TO WRITE THE HOMTOF* FILES. 

Vl* 2.- .3,7 IF YOU HAVE ONLY 32K QK hjvE 4SK OF CORE BUT 

VI? AHE HUNMpJG UEVEL D, ThERF ^IlL NQT BE SUF- 

VI' FICIEnT USE» core to LOAli A 5 SERIES MONITOR 

V16 UMDER TIME SHARING, THE«EfORE YOU wmi. HAVE 

VI* TO lOaO using SPMOw, TmE special SINGLE USER 

VI* H0.>IIT0R. THEREFORE TYPEI 

VI* •SPM0\,3ZK,SPM0N,46K»»,SVE 
V16 

Vl* WHICH wiLL READ SPMON ANO ITS CUSPS ONTO THE DISK. 

Vl* WHEN FAlLSA (OR FAILCU) TYPES •, RESTORE THE 

VI* FOLLOWIMG FILESI 

Vl* •MO^CEN.SAV.S, MAC, COMMON, SAC. SSBl.REUiCOMMOD, MAC, DATDMP, MAC 
V16 

2, a, 4 DEFINE YOUR CONFIGURATION uSlNG McNGEn UNDER TIME SHARING 

TYPEI 

Vl* ,RUN DSK MOMGEN 
Vl* 

Vl* MONGEN WILL ASK QUESTIONS ABOuT YOU« CONFIGURATION 

VtJ SEE MONITR.OPR SECTION 2,1 (STARTING WITH 

Vl* 2,1,12), (PUT CONFIG, MAC ON OSK BY TYPING JUST 

VI* CARRIAGE RETURN,} 

2,0,5 ASSEMBLE COMMON CAND COMM0D3 UNDER TJME SHARING 

Vl* 2.tS,5,l ASSEMBLt COMMON BY TYPINGi 

Vl* ,COM S*C0NFtG*C0MMON/C 

Vl* <■ 

VI* 2,e,5,2 ASSEMBLE COMmOD 8v TYPING) 

(IF YOUR ARE MAKING A DJSk SYSTEM} 

VI* ,COM S*CONFIG*C0MHO0/C 

Vl* 

VI* -OR- 

VI* .COM S*CONFlG*DATOMP*COMMoD/C 

Vl* m 

VI* IF YOU WANT TO BE ABLE TO LOOK AT FUSER CORE 

Vl* BLOCKS IN EXEC MODE FOR OEBUGCINCI OATOMP IS 

Vl* 700 LOCS, 
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Vl* Z. 15.3 OBTAI'4 CRCr LIST1^GS *JY TyPlNGI 

Vl«> 2. .S.I IF you HAVE. SijFFICIEhT USER COSE TO LOAD A 

V16 MOMITOR UNDER TIME SHAHI^■Gt CO TO SECTIONS 

Vie 2,3 ANO 2,4. OTHEH^ISE YqU MUST COPY SOME 

Vlb Fats TO DECTAPE 8EF0NE USINC SPMONi AS rOLUOWSI 

2. '.6 COf FROM DJSk Tq OECTAPE TO BE USED 8t SPMON 

(if ^UT f.OUGH USER CORE TO UOAD MONITOR UNOE« TIME SHARING) 

Vl6 , ASSIGN DTA3 

V16 

VlO OTAi ASSIGNED 

Vt6 

Vl6 «.HtKE 0IA3 CAiJ BE AMY DECTAPfc. REMOVE OECTAPE 

Vie COr-TAI^jlNG FAILCO.SAV IF vOU WISH, 

Vie MOU'jT a SCRATCH TAPE A:<0 2ER0 THE OIRECTORYi 

Vie ,R PIP 

Vie 

vie •DTA3:»/2 

vie •UTA3l/X/e*DSKISPH0N,>,*,SVE 

vie 

vie tABEL THIS TAPE "U/te MONITOR MAKER" BECAUSE 

Vie IT HAS MOST OF THE FIl.ES fc.HlCH ARE ON THAT 

Vie OECTAPE IMAGE, MOUNT A SECOND SCRATCH TAPE 

vie ON 0TA3 ANO TYPEI 

Vie .ASSIGN 0TA3 

Vie 

Vie ,R PIP 

vie 

Vl* •0TA3l*/Z 

vie 

vie 'OTaS I /X/S<-DSKt COMMON, REL,COMHO0,RELi5St)l.ReL 

Vie 

vie 2. ,-(,6 N0». USING TENDMP, UOAO SPMON FROM "10/48 MONITOR 

Vie MAKER" OECTAPE YOU HAVE JjjST WRITTEN, USE 

Vie SPMON, 3<;K if you HAVE JZK, USE SPMON, 4BK IF 

Vie VOU HAVE 48K OR MORE PHYSJCAI. CORE, SEE SECT l.l 

vi7 FOR tfnump Instructions, 

vie 2. ,4, 7 UOAU your MONITOK while KyNNlMG UNDER SPMON, 

Vl6 USIWC LOADER, SVE FROM "lld/AB MONITOR MAKER" 

Vie OECTAPE. SEE SECTION 2,i FQH LOADER INSTRUCTIONS, 

Vl' 2... ,4.1* SAVE YOUR MONITOR ON OECTaPEI SEE SECTION 2,4, 

Vie TO LOAO YOUR MOMTOM FROM OECTAPE WITH TENOMP 

Vl* 00 SECTION 1, 
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2.1 DEFI^iE CUMFIGURATION f ILt USING mONJEN 

2,l,i nDi.GEN IS A PROGRAM WHICH WIUL ASK YOU QUESTIONS 
ABCUT YOUR HARDWARE AND SorTWAHE CO''"^ I CURAT lONS^ 
yOijH Af-iSi^ERS WILL 8E WRJTTEM AS A MACKO SOURCE FILE NAMED 
CO^flG,MAC. THEN YOU WILL ASSEMbuE IT WITH S.KAC AND 

vl« co^'HON,^^AC to produce common, rel, cfo" lo/sa and 10/41SD 

(LEVEL DISK) YOU MILL ALSO COMBlME S.MAC, CONFIG, MAC, 
Vl* ANO COMMOO.MAC 10 FORM C0MM00,HEL,3 FINALLY YOU 

MILL LOAD COMMON. REL CAND COMM0D,REl3 AND PERFORM 
Vl« A SEARCH ON THE APPROPRIATE MONITOR LIBRARY FILE- 

VI* 5N»»,REL OR »S#».REL, M0N6EN HAY BE RUN UNDER A REGULAR 

vi* i0/'i»' OR ia/5a time sharing system {Jf you have one already), 

HOkEVERi THE following INSTRUCTIONS HaVE SEEN wHJTTEN 
FOP THE USER STARTING FROM SCRATCH »HTH JUST Tnt MONITOR 
DECTaPE SOURCES ANO SPMON » THE SPECIAL 10/33 
SP.GLE USER MONITOR, THE OPERATImG INSTRUCTIONS 
FOR RUNNING MONGEN UNDER TIME SHARING ARE THE SAME AS 
UNDER SPMON ■> THE SPECIAL la/iB MflNIToR, 

NOTEI THE 10/3H MONITORS LOOK FOR ANO WRITE A FJLE EXTENSION 
OF ,SVE WHILE t«/4*' AND 10/50 MONITORS LOOK FOR AND WRITE ,SAV, 
THEY CANNOT BE INTERCHANGED BECAUSE THE JOB DATA AREAS 
Vt$ ARE INCOMPATIBLE. ALTHOUGH SPMON IS A 10/30 MON]T0R< 

V15 IT IS SPECIAL IN THAT IT WRITES SaVE FILES WHICH ARE 

ViS COMPATIBLE WITH ia/4B ANO 10/50 MONITORS InSTEAU OF 

VI? 10/33 MONITORS. IT IS USED TO CREATE ,SVE MONITOR 

Vl? FILE WHICH CAN Be LOADED WITH A 10/40 OR 10/S0 GET 

Vl» COMMAND FOR DOT PATCHING, 

2.1.2 LOAO TENOHP INTO CORE ACCORDING TO THE DETAILED 
Vi5 INSTRUCTIONS GIVEN IN SECTION 1,1, IF YOU HAVE 16K 
VIS OF COREt USE SPM0N.16KI 32K OF CORE. USE SPMON, <92K| 
Vl5 48k or MOREi USE SPMaN,48K, 

2.1.3 MOUNT "ie/40 MONITOR MAKER" (EVEN IF MAKING A IB/Sa SYSTEM) 
ON OeCT/iPE UNIT 0. SET WRITE SELECT SWJTCH ON TOP 

LEFT ON DECTAPE UNIT TO WRJTE LOCK (BOTTOM PUSHED IN), 
THEN TYPE TO TENOMP 
0t (S«ALT"MOOE) 

tenohp will Then read the directory from dectape b, 

2.1.4 TYPE 

SPmON 16k cor SPMON 32K OR SPmON 48K] 
FOLLOWED BY CARRIAGE RETURN ON THE CONSOLE TELETYPE, 
TENOMP WILL LOAD ANO ACTIVATE A SHALL 10/30 MONITOR) 
SPMON, TYPE THE DATE ANO TJME AS REQUESTED 
BY SPMON AND SPMON WILL TYPE A PERIOD ON THE CONSOLE 
TELiTYPS TO INDICATE THAT THE USCR CAN TYPE MONITOR 

COMMANDS, THE l>/30 MONITOR COHMaNDS ARC ALMOST 
IDENTICAL TO THE 10/40 ANO %t/9» MONITOR COMMANDS, 
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i.i.i TYPL 

FntuDstU BY C4RHUGE RETjRN TO SPmO'J TQ ASSIGN OECTAPE 
UNIT ^ (0]*L SET TO 8), NOTE! SP,''0^'S CONPIOURATJON 
MAr> U\LY UECT4PE UMTS UTAB.DTAli AK;D DTA2, 

TYI-d 

iSf Iu\ OTAl 

Fni.LJ«.EO BY CARRIAGE RETURM TO SPmON T" ASSIGN OECTAPE 

u'lT 1, 

TVf t 

iSSlGfJ 0TA2 

rCLLOwtJ BY CaRHIAGE return to assign OECTAPE UNJT 2, 
Vis l-artl IT IS iMfEHATlVt THAT YOU aSSIG'J ALL THREE 

Vlb DECTaPES BEfORE YOU USE ANY OF TheH, THIS INroRMS 

V15 SF'J. THAT YOU INTEND TO USE ALU THREE AND PREVENTS 

VIS bP: j;m FWOM TRYING TO USE THE DIRtcTOHY SUFFER SPACEi 

2,i,7 '^OL'^it A BLANK TAPE OM DECTAPE UNIT li THIS TAPE WltU 
RECEIVE FILE CQNFIG.nACI SO SET WRITE SELECT SwJTCH 
O'i TOP LEFT QF UECTAPE UNIT TO WRITE (TOP PUSHEU IN| 
►RITE ENABLED LIGHT SHOULD BE ON). 

i.i.S TYPE 
R flH 

FOlLQUED by carriage return to SP-ONi to load AND 
START PlP.SVE, The PESIPhERAL INTERCHANGE PROGRAM, 
UHVi DTAiJ STOPS SPINMINGi PIP WILL TYRE AN • AnO WAIT 
FON INiPUT, CIF YOU ARE RUNNING UNqER A l!>/4e OR 10/90 
rO.-.ITORi ALSO TYPE R PIP3. 

7. ,1,9 CLEAR OTaI AND COPY CONFIGURATION DEPENDENT SOURCE 
FIuES FROM OTHER TAPES, IF THE SflURCES ARE ALREADY 
V16 Cl>l THE DISK COPY THEM DIRECTLY FRQM ThE DISK TO'DTAli 

Vl6 RATHER Than FRQH 0TA2 TO DTAl AS DESCRIBED BCLOWi FOR USE 

V16 i-IT-i SPMON (SINCE SPMON CANNOT ACCESS THE DISK), 

2.1.^.1 TYI-L 

0T4ll»/2 

FOLUCWEU BY CARRIAGE RETURN TO PIP TO CLEAR (ZERO) THE 
DIRECTORY 0^ UNIT 1 IN CASE IT HAS SOmE FILES ON IT, 
DTaI hill move AND PiP HILL RESPOnD "ITH • MHEN IT 
MAS f INISHEO, 

2.1.^1,2 TYPE 

<ClSTROL>C 

BY lOLDlNG ilO.N THE CONTROL KEY (lEFT HAND CORNER OF 
KEvaDAHD) ANO PUSHING C, SPHON HIlL RESPOND BY 
TYPING »C FOLLOWED BY TWO CARRIAGE RETURN LINE 
FEEUb ANU A DOT. 
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Vlt> 2.1.9.3 COt^Y S.MAC fRoM "ASSEMBLY TARE" (tAOL «3) 

Vis TYC=L! 

V15 ASSIGN DTA2 

Vl^ TO I'IFORM SPMOv T-UT A NEW TAPE! Is ASnuT Tc 3E Mou,mTEO 

VIS f.OlMT "ASSEMBLY TAPE" (TAPt »i) C TTa? 

Vis TVPtl 

V15 STa-^T 

Vl5 TO START PIP nvER AGAIN, PJP WILL RESPOND WtTH •, 

Vis TY^tl 

Vl5 0Ta1I/X/B*UTA2;S.maC 

VIS PIP i^ILL RESPONO WITH AN • WH£,\, [r HAS FIMISHED 

VIS THt.) type; <00 not type ANEAU HJT^ SPMON, IE WAIT UNTIL • 

Vl5 IS TYPED) <CO\TROl.>C 

Vis 2,1.9,4 COPY COMMON. MAC FHOrt HONITOR SOUKr;E FILES TAPE (TAPE #4) 

Vl5 TYPEl 

V15 ASSIGN 0TA2 

^1* TO 1:>IF0«M SPMON THAT A NEW TAPE IS ABOUT TO BE MOUNTED, 

V15 MOUNT "MONITOR SOURCE FJLES TAPE" (TAPE »4) ON UTA2 

Vl5 TYPEl 

VIS sTaST 

VIS TO START PIP OVER AGAIN, PIP WltL RESPOND WITH AN •. 

Vl5 TYPE) ■ ' 

V15 DTA11/X/B*DTA2IC0MM0N,MAC 

VI' PIP WILL, RESPONU i<ITH AN • WHEN IT HAS FINISHED 

Vl5 THEN TYPEJ 

VIS <CONTROL>C 

VIS 2.1,9.5 COPY COMMOD.MaC AND DATOHP.MAC FRoM "LEVEL FILE SYSTEM 

Vl5 SOUKCES" (TAPE »14>.-^0NLY FOR DISk SYSTEMS (lB/*eD, 1I8/5B> 

V15 TYPtI 

VI' ASSIGN OTAZ 

Vlf TO INFORM SPMON THAT A NEw TAPE IS ABOuT TO BE MOUNTED 

V19 MOUNT "LEVEL D flLE SYSTEM SOURCES" JTAPE »%*) ON OTAZ 

VIS TYPEl 

V15 STa«T 

VJI TO START PIP OVtR AGAIN, PIP KILL RESPOND W|TH A •, 

VI' OTAl I /X/B»DTAZ I COMMOD.MAC I OATDMP, MAC 

VI? PIP Witt RESPONO WITH AN • WHEN |T HAS FINISHED 

Vl5 THEN TYPEl 

VIS <CONTROt>C 

VIS 2.1,11 MOUNT AND START MONGEN 

Vis TYPEl 

VIS ASSIGN 0TA2 

VIS TO INFORM THAT * NEW TAPE JS ABOUT TO 8E MOUNTED 

VIS MOUNT "ASSEMBLY TAPE" (TAPE #3) Om DTa2 

Vis TYPEl 

VIS RUN OTAZ MONGEN 

FOLLOWED BY CARRIAGE RETURN TO SPmQN TO LOAD 
AND START THE CONFIGURATION DEFINITION DIALOG 
PROGRAM* MONGENi 
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c.i,i2 ■-.. <OEN i'lLL '^ESPO^fJ WITH 

TVf't •"Ut*'Ii;t:\AME<CH>" fOH WHERE TO PUT RESULTS 
C THIS DIALOG! CR ASSU>1ES "OSKI cONFIG.MaC" 

bIwCE SPMO^ DOES fvOT HAVE A OSK (LARSFIK 10/3B HONITORS 
►lAVL A UISK riLE STROCTUqE wwicw IS I^JCOMPATIBLE WITH 
1 /4,- AND lfV5^ SYSTEMS), TYPE 
UTAj;cONFI5 

FrLLO-tO BY CARRIAGE RETURN TO KcNGEn (AFTER YOU 
Mivt MADE YO-JR MOMTOR, YQU ;VILL BE ABLE TO 
S' o i^ONCLN.SAV U^iOER IT INSTEAD -JF MQ^CEN.SVE 
u,'-. .,tn SPkON) 

2.1.i3 ''C'lGEi; KILL TYPE 

A bt-ER THE fCLLO-^JNG QUESTIONS "ITH Y OR N 

01. A DECIMAL VUMBER 

SnJ*iT UIALOG? [N«lOnGER QUESTIONS] 

IT IS HECO-MEMJED THAT YOU TYPE -j FOLLOWED BY 
CtRHIACE RETURN UNTIL ^0[i ARE MORE FAMILIAR 
-JlT-1 MONGER, BECAUSE MONGEN WILL EXPLAIN THE 
(JuLiTIOMS «OflE FULLY BY TYPING txTRA COMMENTS 
I SIOE SQUARE BRACKETS, 

2.1.14 ti,,v(.E^ atlLL wRItE EACH QuESTIONt 

A. 5-<EH AMD Symbol definition in file CONFIC.MAC, 

BFCAUSE MOST OF THE OUESTION ARE STRAIGHT-- 
Fl'^'ARO, THEY HAVE MOT BEEN INCLUDED HERE, SEE THE 
LlSTInt OF C0NM5.MAC IN MONITOR LISTING OF COMMON 
Ft,'^ A SAMPLE DIALOG, ONLY A FEW ARE EXPLAINED MORE 
FULLY BELOW, 

2.1.1'',1 TYPE "SYMBOL. VALUE" (VALUE I'J DECIMAL) 

F'.H A.IY SYMBOLS TO 9E DEFINEU, TYPE EXTRA 
V14 CA-^RIACE RETURN WHE'J THROUGH, ThEN IT WILL ASK THE 

Vll SaWl 3UESTI0N fOR OCTAL VALUES, 

Vli> IF YOu DISCOVER THAT YOU ARE RUNNING MONGEN OFTEN, 

Vl» IT IS HECOMMENUED THAT YOU EDIT THE BEGINNING OF 

Vl5 CO'IMON.MAC CAND/QR C0MM0D,mAC3 Sq THAT YOU WiLt NOT 

vis ACCIDENTALLY BURD A MONITOR WJTh AN INCORRECT SYMBOL 

Vis VALUE, HCWEVEH FOR THE FIRST Ft.« TIMES, CHANCING 

Vl5 ThE SYMBOL VALUES WITH MONGEN WIlL SUFFICE. 

H'i. FOLLOWING SYMBOLS CAN BE CHA.xGEU TO BE DIFFERENT 
FKOM THE STANOARO, THEY ARE SHO.<N WITH THEIR STANDARD 
(lECIMAL) VALUES, IF YOU ARE SATISFIED WITH THE STANDARD, 
JUST TYPE CARRIAGE RETURN LINE fZlU, IF YOU QC DECIDE 
Ti CHANGE ONE OR MORE Of THE FOLLOWING SYMBOLS, TYPE 
Tt-L SYMBOL FOLLOWED BY ITS DESIRED VALUE SEPARATED BY 

A COMMA, PUT Each symbol definition on a separate 

Lnt, TYPE AN EXTRA CAKRIAGE-RtTURN LINE-FEEO WHEN DONE, 
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PuNER FHlaUEnCV IN HiKTi tCVcUE!" "i-** SECONU), 

SOME INSTALLATION'S ShoULJ CHa-MGE THIS TO 

5i SO THAT ACCOUNTING AND THE OF DAY WJ1.1. BE 

CONHECT, 

Z. 1.14. 1.4 fJTTRYt* 

NO, OF TiMtS TO TRY Qfi OECTAPE tSPOHS 

2,1.14.1.& NITSI2,128 

SIiiE OF MAGTAPE RECORDS 

2.1.14.1.6 LPTSU.26 

SI2E OF LPT 8UFFER+2, 

THIS SHOUulJ 8E MADE 29 IF YQu HAVE 132 CHA« 
LINE PRINTER AND WANT TO PRJmT On ALL C0LU1NS 
WITH FORTRAN, 

Vl4 2,1.14,1,7 NSPMEM,100B 

NU?1BER OF NanO^SECONOS PER MEMORY CYCLE 

V15 (SHOULD BE 176Z FOR Maia MEMORIES). THIS 

IS ONLV USED TO COMPUTE THE AMOUNT OF TIME 
SPENT CORE SHUFFLING AS PRINTED SV THE 

V15 SVSTAT COMMAND, 

VIS 2. 1,14, 1. « MINC0R»J0BN»64 [LEVEL»C ONLY] 

THE MONITOR RESERVES A TABLE OF AT LEAST MlNCOR WORDS 
(POSSIBLT MORE UP TO THE NEXT IK BOUNDARY FOR ALLOCATING 
DISK DEVICE DATA BLOCKS, MInCOK IS NORMALLY 54*J0BN 
WORDS ALLOWING l,b OPEN DISK FjLES'PER JOBi IF THE 

Value for mincdr is too small it may be supplied 

DURING THE MONGEN DIALOGUE, THE TOTAL SIZE OF THE 
MONITOR IS PRINTED OUT AFTER THIS SPACE IS RESERVED 
IN THE LONG ONCE ONLY OIALOC, (SEE 1,9}, 

2. I. 14, I, » LOCSIipZ 

MINIMUM AMOUNT OF VICTUAL CORE REQUIRED IN ORDER 
TO ALLOW A USER TO BE LOGGED IN, IF THIS AMOUNT 
IS NOT AVAILABLE! USER W]LL RECEIVE USUAL CORE 
UNAVAILABLE MESSAGE INCLUOING AMOUNT OF VIRTUAL 
CORE LEFT. THIS VALUE MUST qE AT LEAST AS BIG AS 
LOGIN CUSP (CURRENTLY 2K) 
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V14 2.1.14.1.11 bTRMAX,l4 

V14 THE MAXIKUM NUMBER OF OlSK FILE STRUCTURES 

Mi,A hMICH CAN RE ON tINE AT ONE TIME, DECREASING 

vi4 This Value saves one hord per valuEi 

..,vl4 2.1 .14„lUi CCWMAAi la 

Vl4 T^E MAXIMUM LENGTH OF A DISK CHANNEL COMMAND 

Vl4 LIST, ALTERING THIS VALUE AFFECTS ONL» 

\,14 THE EFFICIENCY ANO SPACE CI WORD PER CHANNELJi 

Vl4 2.1.14.1,13 S«PmaX,3 

V14 ThE maximum number of disk UNITS WHICH MAY BE 

vi4 uSLo FOR Swapping, ci jord per unjtji 

Vl4 ?. 1.14. 1,14 S*CLSN,7 

«14 THE HIGHEST CLASS NUMBER FOR SWAPPlNGi 

Vl4 2.1.14.1,1& DSKTRY.i 

V14 NO, Of TIMES TO TRY ON OISK ERRORS, 

Vl4 2,l.l4.1,ia CHVIFP.IB 

V14 STANDARD FAIRNESS COUNT FOR POSITIONING, 

Vld CSEE USKI216,MEM SECTION ll«,3,^J 

Vl4 2.1.14.1.19 CHUIFP.CHVIFP ... CH7 IFp.CMVlFP 

V14 FAIRNESS COUNT FOR POSITIONING ON CHANNEL B.,.,7. 

Vl4 2.i.l4.1.ZJ CHVIFT.ia 

V14 STANDARD FAIRNESS COUNT F0« TRANSFERS, 

Vl4 2,1.14.1.21 CH«IFT,CHV1FT ,,, CH7lFT,CHVtFT 

V14 FAIRNESS COUNT FOR TRANSFERS ON CHANNEL f>,,,,7, 

V14 CSEE USKZli.MtM, SECTION 1^4.3.^] 

Vl4 2.1.14,1.22 PTRLEN.li; 

V14 NUMgEH OF IN-COHE RETRIEVAL POINTERS PER DISK 

V14 Dua, 

Vl4 2.1,14,1,23 EPL4taO,l2 

V14 ONE-FOURTH THE LENGTH OF THE MAXIMUM tXEC PUSH 

Vl4 DOWN LIST EXCURSION, 
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n5 2.1.14.1.24 FIL4«0,lil 

Vl^ NO, OF 4 WORD BLOCKS ALLOCATED PER JOB IN A COMMON 

Vl= POOL OF MONITOR FRtt COst, TMt. ONCE ONLY CODE 

Vl^ MULTIPLIES THIS FACTOR TIMES THE NUMBER OF 

Vl» JOBS The SYSTEM IS BUILT FOR TO ASSIGN THIS SPACE. 

V19 THESE BLOCKS AHE USED BY THE LEVEL UISK 

VI' SERVICE FOR ACTIVE, DORMANT, AND FREE'aCC, AKH, NMB, PPB» 

V15 AND UFb BLOCKS, THIS PoOL IS PERMANENTLY 

Vl^ RESERVED FOR THESE, BLOCKS AND IS NOT USED FOR 

VI' AMY OTHER PURPOSE, ANOTHER POOL IS USED FOR 

VIS VARIABLE LENGTH CORE BLOCKS SUCH AS DISK 

VI' DEVICE DATA BLOCKS, AND EXTENDED EXEC PUSH DOWN 

VIS LISTS. ENTEKUUO ERROR CODE 16 (.ERNET) IS 

V15 SET IF THIS POOL FILLS uP.' IF THIS ' 

V15 HAPPENS REGULARLY, INCREASE THE VALUE OF FIt4WD, 

VIS jHE MINIMUM NUMBER OF « WORD BLOCKS IS 50 FOR THE SYSTEM, 

Vl4 2.1.14.1.25 UNVRSF,5B» 

VJJ THAT RECIPROCAL FACTOR oF THE TOTAL DISK S|2E 

VI* ON EACH UNIT ONTO WHICH USERS COULO NEVER WRITE THEIR DATA, 

VlJ THIS SAFETY FACTOR ENSURES THERE IS ALWAYS ROOM 

V14 TO WRITE THE SECOND RIB. ETC. l.E, ONE FIVE 

VI? HUNQRETH OF THE 0|SK SPACE IS RESERVED FOR THIS PURPOSE, 

Vt* 2.1.14.1.26 LBNHOM.l 

V14 Le2HOn,10 

Vl* STANDARD LOGICAL BLOCK NUMBERS ON EACH UNJT 

V14 CONTAINING THE HQM BLOCK, 

Vl* 2.1,14,1.27 MF0SI*,8 

VJ* NUMBER OF BLOCKS ALLOCATED TO THE MFD IN EACH 

VI* FILE Structure by the refresher, the mfo can oroh 

VI* LONGER THAN THIS, HOWEVER A SPEED ADVANTAGE 

VtJ OCCURS IF THE MFD IS CONSECUTIVE BLOCKS, INCREASE 

VI* THIS Value if you discover your mfo is usually 

VI* LONGER THAN 8 BLOCKS, 

Vt* 2,1.14.1,30 MBFn,! 

yi* NUMBER OF 128.W0R0 MONITOR BUFFERS, (USED 

VI* FOR READING AND WRITING NQN-USER DATA?, 
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/ 
2,1.1*.^ I'^'^t. "SVBOL'VALUr" (VALUE IN jCTAj.) 

fij^ A.vY SY'«(iOU VALUtS To Bt CMtNGEO FRqm THE STANDARD 
LisTLO BEUO'i. TVPE AN LXTHA CAHHUGt StTURN; 1-HEN THRUi 

V15 t, 1,14, 2.1 STUENSiJ [OCTALJ 

STA.JAHC >«AGTAPE OtfJSlTY IF USER PrOSRa" DOES NOT 
DVf. -!IOt WITH fvON-^ERO VALUE IN KHi OPEN, OR 
StT'-Tb .jUO, 

1 BiNARv <?DD) Parity ♦ inic bpi 
? Bi-^ARY (ODO) Parity ♦ §56 eoi 
3 niNAKY OQU) Parity ♦ h^z bpi 

~ bCO (EVEN) parity ♦ 2i)« bpl 
h hCU (EVEN) PARITY ♦ 5b6 BPI 
7 tiCU (EVEN) PARITY ♦ BUU Fpl 

vi5 ?. 1.1-1,2, 2 I'vOppN,?: [octal: 

Vl> IF I^UPP^»Z, THEiv EACH PROGRAMMER NUMBER REFERS 

Vl* TC THE SA«E PERSON IN EVERY PROJECT, 

V15 IF I,MDPPHa777777, THEN PROGRAMMER NUMBERS MAY BE 

VIS ASSIGNED INOEPENCENTLY uITHI^ EACH PROJECT, 

Vis THIS AFFECTS ONLY ThE UlSK FILE ACCESS PROTECTION 

VI' MECHANISM, LSEE DSK0i6.MEM, SECTION 7,2,2] 

V15 2.1.14,2,^ PRVFIL,<)&/ COGTALJ 

Vis STANDARD FILE PROTECTION. 

Vis 2. 1,14, 2, 4 PRVufU.775 COCTalJ 

VIS STANQARO UFO PRIVILEGE, 

Vl5 2.1.14.2,5 SETwCH.aZBzaiS COCTALJ 

VI* IMTJAL SETTING OF WATCk PARAMETERS FOR EACH JOB IS ALL TOBNEO 

Vis OFF, SEE -iATCH COMMAND FOR A OESCRIPTJON OF JOB STATISTICS. 

Vt' THESE JOB STATISTICS ARE TYPED INSIDE BRACKETS 

VIS t<HEN A USER STARTS TO "^AlT FOR THE SYSTEM OR 

Vis ■ / WHEM The console returns to command leveli 

Vl5 BIT 1 B DAY (ZaaBBiS) 

Vis , BIT 2 > RUN (laaaBK) 

vis BIT .5 « WAIT (40i}fc0) 

Vl5 6IT 4 = READ (20iaeiil) 

VIS (;[T 5 - WRITE (nzisaai 
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Z.l.iS PJ CHANNEU ASSIGNMENTS CAM 3E CrtAjGED FROM ThEIR 

STANDARD VAUULS WHE^n ADDING SPtClALIifEO I/O ROUTINES 
rOR CUSTOMERS' NO'»!-STAND*RO DEvjCES. 

PI ASSIGNMENTS ARE MAUE BY GHQUPlNU I/O DEVlCtS BY 
RELATIVE SPEED OF INiTERRUPTS, As SHgwN BFLQw/ IF ANY 
DEVICE IN A GROUP IS PRESENTi A PI CHANNEL « lUU 9E 
ASSlGiVED TO THAT GROUP, THUS ThE EXACT PI ASSIGNMENT 
FOi< A GIVEN DEVICE VARIES OEPENnlMG ON THE PRESENCE OF 
OTHER DEVICES. 

IN AaOITJON, THE DEVICES ADDED bY A CUSTQMEH DURING THE 
MONGEN DIALOG WILL BE CHAINED O.M THE REQUESTED CHANNEL, 
IF A DEVICE REQUIRES THE EXCLUSIVE USE OF A Pi CHANNELi 
THAT mY BE DECLARED Tq MONGEN Af TER DECLARING THE 
NAME OF THE SPECIAL DEVICES, 

THE DEVICE CROUPS ARE AS FOLLOWS (THESE hAY BE CHANCED 
BY RE-ARRANGING THE DEVICES IN INTTaB, In THE SOURCE OF 
COMMON) I 



VII 



GROUP NUMBER 


DEVICE 


{NOT Pt CHANNEL) 


MNEMONIC 




Dce 




MTA 




OCT 




OTA 




COH 




APR 




SCN 




PTB 




LP I 




OTA 




MTA 




CTY 




OSK 




PEN 




PTP 




CDP 




PLT 




DIS 




CL« 



NAME 

136 OAT* CONTROL FOR 270 DISK 

TM10A Data channel 

li^ DATA CONTROL FOR »M OR &16 

tape controls 

toxb oectape data channel 

461 OR CRl^ CARD READER 

KAliil OR 166 arithmetic PROCESSOR 

0Ciei682i OR bit TELETYPE SCANNER 

PAPER Tape READER 

LINE PRINTERCSJ 

OECTAPE FLAG CHANNEL <DTA OR OTC) 

MAGTAPE FLAG CHANNEL 

CONSOLE TELETYPE 

DISK FLAG CHANNEL (FHD,MOF,OPC| OR OPO) 

LICHT PEN 

PAPER Tape PUNCH 

CARD PUNCH 

PLOTTER 

DISPLAY DATA CHANNEL 

SCHEDULER' CLOCK ROUTINESi 

(ALWAYS ASSIGNED TO CHANNEL 7.) 
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2,2 ASSEMBLE S»CONr|0*eOMf10N tANO S*cONF|G*cO'1'^00? USINC MACRO 

2.2.1 (.HEN HOMCSN TVPtI "EXJT 'C. YOU HAVE CHEATED 
nut CONriG.HAC (ON OTAl IF USINb SPMON), NOW 
YOU MUST ASSEMBLE IT WITH SiMAC ll^D COMMON, MAC 
TO P!<ODUCE COMMON, REL. 

2.2.2 TYPE 

aSSISN DTA2 

FOLUOWEU BY CARH|ACE RETyRN TO SPhON TO 

ASSICN OECTAPE Unit 2, 

2.2.3 MObNT A BLANK TAfE ON 0TA2 
SET THE UNIT TO MRITE ENABLED 
TYFEJ 

K PIP 

CLEAN THE DIRECTORY ON UTA2 BY TYpINOl 

DTA2J*/< 

PIP "JILL RESPOND WITH A • WHEN IT IS DONE 

THt'V TYPEI 

(CC^TROL) C 

2.2,1 TYPE 

,R riACRO 

FOLLOWED BY CARRIAGE RETURN TO SPmONi TO LOAD 

AND START MACROt THE SYMBOLIC ASSEMBLER, 

MACHO wlLL TYPl AM • AND WAIT FOR INPUT, 

lU YOU ARE RUNNING UNUER A lli9/4» OR 

10/5? MONITOR INSTEAD OF SPMONi *lSO TYPE 

R ^'«CROJ, 
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2.2.5 TVrt 

V15 DT a2 I COMMON»DTAl IS, CONFIG, COMMON 

FOLLOinEB BY CARRlACt RETURN TO MACRO, 
THE ASSEMBLER villi HAKE TWO PASSES OVER THE 
SOURCE f-JLtS AND PRODUCE COHM0;>i,REL Om 
DECTaPE unit 2. WHEN MACHO IS FIImiSHED, IT 
SHOUUQ PRJNT NO ERRORS UtTECTEO 
FOLLOHEO BY •. IF THE ASSEMBLER SmOULD OETECT 
SOME ERRORS, CHECK YOUR MONCEN DIALOG, 
ESPECIALLY WHEHt YOU DEFINED SPECIAL SYMBOLS 
OR UEVI?E ROUTINES, MAKE SURE THAT YOU 
SEPARATED EACH FIELD WITH A COMMA AND 
TYPED NO SPACES, (MONGEN TAKES EACM SUCH 
LlNt AND PASSES IT DIRECTLY To CONf It.^AO , 
IF YOU CANNOT FIND YOUR ERROR, PERFORM 
THE ASSEMBLY OVER AGAIN WITH A LlSTJNGI 
DIAZ I COMMON, LPT I "DTAl IS, CONFIG, COMMON 
AND LOOK TO SEE WHERE ERROR OCCURRED, 

Vl' CFOR LEVEL DISK SYSTEMS ONLY. AlSO TyPEi 

V19 DTA2iCOHHO0*DTAllS,C0NF|G,COMMOO 

VI? TO MACRO AFTER IT HAS FINISHED PREVIOUS ASSEMBLY 

V19 AND HAS TYPED • 

V15 IF YOU ARE INTERESTED IN LOOKING AT THE LEVEL CORE 

Vl» BLOCKS WHILE RUNNING IN EXEC MODE, TYPE THE FOLLOWING 

V19 COMMAND STRING INSTEaOI 

V15 0TAZICOMM0D»DTAllS,C0NFlC,DATQMP,cOMM0D 

Vl| THIS WILL INCLUDE DATOMP WHICH IS ABOUT 7Btl OCTAL LOCATIONS LONG 

2.2.6 TYPE 
<CONTROL>C 

VI* TO MACRO AFTER IT HAS FINISHED ASsEMBlY AND HAS 

TYP|D "TO 
RETURN TQ SPHON COMMAND LEVEL, 
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d.i L0V3 CCi":UJ,REL CANO COM'iOd . KE13 FOLLOWED 9Y mqhiTOR UIBRARY 

FILF USI'.- LCAOEK. (SEE »EFE«tNCt HANOboOK FOR EXPLANATION OF 

LOAilR CC-^mA'jOS ANU S'MRDLS,) 

?.3,1 TVt t 

F'lLLnwED sv Carriage return to spmon which will load 
loajlh.sve which is a standard loader saved to run under 

i i /3i^ MONITOR IMSTEAO OF A 10/*.* 0" IB/SB MONJTORi 
CK YOU ARE LOaOING UNDER TIME SHARING INSTEiD OF SPHON 
ALta TYPE R LnADER3, CIF YOU ARE M»KIMG A 10/58 SYSTEM 
VCi. HOST REPLACE THE "lil/«a MONITOR MAKER" (TAPE «2) TAPE 
«ni THE "1?/5J MONITOR REL FILES" TAPE (TAPE #7) AFTER YOU 
V14 HAVE GOTTEN THE LOADER OFF OF IT (WITH THE R COMMANOJ, TO 

DO THIS TYPE <C;0nTR0L>C FOLLOWED BYI 
ASilGN OTA.; 

SC! THAT SPHON WILL KNOW TO READ ThE DIRECTORY AGAINi 
Th: . REPLACE '•l*)/4ia MONITOR MAKER" TAPE (TAPE »2> HITH 
"1 /5t MONITOR nil FILES" TAPE (TAPE *7) AND FlNAtUV TYPEI 
STf^T 
TO 5PM0N TO RETURN TO THE LOAOER) 

2.3.2 .;E«1 YOU MUST TYPE THE LOADER COMMAND STRING TQ CAUSE 
IT To lOaD YOiJH TAILOR MADE COMMON, REl FROM 0TA2 AND 

Vl* 00 A LIBRARY SEARCH OF SN##,REL OR 5S##,ReL ON 

DT« , THE LONG MOnGEN DIALOG TYPED OUT THE APPRO- 
priate command string for you to usei the following 
sfctions. 2,3.2 through 2,3,4 describe the loader 
co^■1a^io strings* in cast you did not specify the 
lc: i dialog. if you discover ydu made a mistake before 
typi,mg /u. you may start loader Over again merely by 
tyung <c0nth0l>c 

STAi<T 

FOLLOWED BY CARRIAGE RETURN TO MONITOR. 

2.3.3 TYIL 

/S 

FOLLOWED BY CARRIAGE RETURN, TO LOAD LOCAL SYMBOLS FOR 
DEi-uGGING THE MONITOR WITH EXEC DDT OR PATCHING WITH 
EXIC DOT (STAMD-ALONE IN EXEC MODE OR UNDER TIME SHARING 
l^' USER MODE) , 

Z.S.'; TYI-t 
Vl* DTAi;tC0MH0NiDTAl«l5N##/L 

FOLLOWED BY CARRIAGE RETURN IF YCu ARE BUILDING A 10/40 

MOl.-UISK SYSTEM OR TVPtl 
Vl* DT42lCOMMONiCOMM0D.OTABi5S##/L 

FOLLOWED BY CARRIAGE RETURN IF YOu ARE BUILDING A LEVEL 

DISH SYSTEM (l»/40 U OR li/SH) SYSTEM. THE /L TELLS THE 

LOtJER TO DO A LIBRARY SEARCH HAThEB THAN LOAD EVERY FILE 
V14 I^ 5'<#»,REL OR 9S#«iREL, COMMON, REL CONTAINS THE PROPER 

EXTERNAL DECLARATIONS TO LOAD JUST THE ROUTINES NEEDED FOR 

YOU** CCNFICURATIQM, 
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i.3.5 TYwtl 

LPTI»/A/M/P/G 

V15 hOTEl EXEC D3T (EDDT Vii^l WILL EXECUTE EITHER IN EXEC 

Vis MOOc. OH USER MOOEi SO THAT ONLY OnE CO^T OF DQT I^ILU 

vl» SUFFICE FOR Patching umder Tint sharinc. or stanU.alone, 

THE UOAUER i«ln. PRINT A STORAGE M^P 0?,; THE LINE 

PRmER AND WILL TYPE 

EXIT 

taHEfV IT IS THROUGH, IF YOU 00 NOT HAVF A LINE PRINTER, 

/P/G 

FOLUOKEO BY CARRIAGE RETURN 

THE /A PRECEDING THE /M CAUSES 

THE LOAOER map To INCt-UOE ALL GLOBAL SYMBOLS 

INCLUDING 2ER0 LENGTH FJLES (JOBUaT), THE /P SWJTCH 

PREVENTS THE LOADER FROM SEARCHING THE LIBRARY IN 

CASE THERE ARE UNDEFINED GLOBALS, THE /G IS EQUIVALENT 

TO ALTMOOE AND SEEMED LESS CONFUSING TO INCLUDE HERE 

SINCE THE USER Can END ALL COMPUTER INPUT WITH CARRIAGE 

RETURN. 

INSTEAD OF PUTTING THE STORAGE MAP ON THE LINE 
PRINTER YOU MAY WISH TO PUT IT ON DTA? INSTEAD FOR 
LATER PRINTING, IF SO TYPE 

DTA8IXXXH0N*/A/M/P/C 

WHEHE XXXMON IS THE NAME OF YOUR MONITOR, THE LOADER UlUL 
WRITE STORAGE MAP AS FlU XXXMON,M*P ON 0TA2, IF YOU GET 
... ANY MULTIPLY DEFINED GLOBALS CHECK TO SEE THAT YOU TYPED 

VI* /L IMMEDIATELY FOLLOWING 5N## OR 55##. |F LOADER 

"UNS OUT OF CORt, IT WILL PRINT COHE EXCEEDED FILE 
VI* 5N#» COR 5S#«3 CHECK TO MAKE SURE YOU aAE USING THE 

LARGEST SPMON FOR YOUR MEMORY SliE (SPM0N.16K.SPM0N,32K, 
SPM0N,4eK) IF YOU WERE NOT, RELOAD L*RCEST SPMON WHICH 
WILL FIT IN YOUR MEMORY AND GO BACK TO STEP a,3i CHECK 
TO HAKE SURE YOU TYPED /L AFTER ThE LIBRARY FILE, OTHER- 
WISE LOAOER WAS ATTEMPTING TO LOAo ALL FILES, TO RECOVER. 
TYPE <CONTROL>C START TO MONITOR, IF CORE IS STILL 
EXCEEDED TYPE <C0NTR0L>C START ANq REPEAT STEPS 2,3,3 
THRU i,a,9 EXCEPT DO NOT LOAD LOCaL SYMBOLSI/S, ) , 
IF THIS FAILS TRY LOADING WITHOUT EXEC DOT (MUST REPEAT 
MONCEN DIALOG aNO ANSWER N» , AND WITHOUT LOCAL SYMBOLS, 
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-•A\/f ■,«:T-:i uZH-S, ••i''IToH SAVL C0'"1'^A»JD 



?.4,i voi. r,ijt JUST loaolu rauM (i^nitoh ivTo core, using 

■^0* YliJ >iLiST SAVE IT OM dECTaPI SO THaT 



1;. JL- 



IT Ca . dt LCiA-'KLP tjV TtijOMP, 
TV. c 

f?tL:'A'.u bY A CAnmAGE WtTuR-^ TO SP-'Cl-Ji WHERE XXXMQN 
IS Tni ,,AMt. Y-ij WOULD LIKE TQ GIVE TO YOUR MONITOR, 
L,P .1! ULL -RITt FILE XXX>10M,SVE 0^' OTAZ, IF YOU 
iSt. •M. WMl- UsntR TIME SHAKING, ThE MONITOR WILL WRITE 
ruL xxXvON.Sav TiSTEADi TEN'JMP *ItU BE ABLE TO LOAD 

^A. li,. - \i.^ZH COPT A ,bVE OR ,SaV FILE ONTO A OECTAPE 
*rTM PIP WnICi.i YOU '^AY WJSH TO LOaO WITH TEMOHP (EG 
'O-lTOr! OR SO^'E MAINTENANCE PROGRAMS) , A1.WAYS 
.^Sf TnL MO.\ITnR GET AND SAVE COMMaNQS INSTEAD, PIP 
(-ITh /b Sk-ITr-l) IS FINE FOR ORDINARY USER PROGRAMS AND 
nu;>=i lVEN ThpuGH THEr ALSO HAVE EXTENSIONS OF SAV AND 
■j-^i i-rUL YOU /.lUL NEVER LOAD THEM kITH TENDHP , 
Vis T^^f :(tASOr< FG'' ThIS RESTRICTION IS THAT TENDMP 

V1& aS^u-Lo That TmE FIRST BLOCK OF A FILE IS THE 

VIS LO tST 0-jE Vi THE TAPE FOR THAT FILE. TENDMP 

Vis WVA' r'Avt TO bt tAHGER IF IT WAS TO 8E MADE 

Vis CO' P4TIBI.E. 

?.■*,:■ iiEc'TAfF: dta;^ snuuud nOx contain the following fjues 

C'J'-'ron.REL 

VI* cy-'r-CU.RtL CIF LtVEL-D OISkJ 

xxxMijN.MA? CIF YOU WROTE STORAGE MAP HERE3 

XXX-.'^M.SVE COR XXXf^ON.SAV IF UmOER TIME SHARINGJ 

VI* <■.-!.-' AFTt-.^ .■HI\GI'<3 UP YOUR LLVEL MOrvITOR, 

Vl6 L'--( I >.fsDEf. 1,4 A.\D SAVE'vnJR MONITOR ON A SuO'W SPEED FItE 

V16 sTi-g^TuhE "ITh The ■■'ame system, sav. then you will be able 

V16 TO t^iAL- IT '^ERfLY BY TYPING CaRRIaGE RETUR(« TO SOOTS, 
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3. kOW to AbJtMtiLE. HO'MITOR SajSCLS, ANJ CHtATt HBHAHY FltE TO 

PBOCUCE 4 ^iE». MOMTns. 

3, a REaulHEC t,JMPONE\TS 

3.>?.i A h-UrlNilNG TIMr SHABJ^jS SYSTEM EIT«C» lf-/4i8 Qi? lH/ii, 
yj* ^OIJ *"IUL USE Tut fOLL0wII>.G CUSPS! MACHO ( VEKSION 42 

.''*• 0" LATER), PIP. FgOGEZ(0PTl0MA|.), COi"PIL<OPTIONAUI , 

3,il,^ THt MONilTOR SOURCE OECTAPEs LABEUEU! 

Vl* MONITOR SOURCE J 

VI* MONITOR SOURCE 4 

Vt* lOMITOR SOURCE 5 

VI? ".ONI TOR SOURCE 6 

VI* "MONITOR SOURCE I* iLEVEfD SOU«crJ 

"1* MONITOR SOURCE 15 CLEVEu-O SOURCE] 

Vl* - OR - 

Vl* fOMTOR SOURCiS ON A FAItSAFE MaGTAPE, 

3.1 ASSEHBUE MOf.ITOR SOURCES AUTOMATICALLY uSINq THE MACRO INDIRECT 
FEATURE 

3.1.1 TWO HETHOOS OF ASSEHBUING THE MONITOR ARE DESCRIBED HERE, 
ONE IS AUTOMATIC AND ASSEMBLES EVgRY ROUTINE OF THE 
MOMTOR WITH A SINGWE COMMAND STRING, IT USES THE INDIRECT 
FEATURE OF MACRO TO REAU A FILE OF COMMANDS, |t HILL EVEN 
VI* WORK ON lB/*0 SYSTEMS PROVIDED THAT 7 DECTAPES ARE AVAILABLE. 

THE SECOND METHOD (SECTION 3,2) DESCRIBES MOW TO ASStMBLE 
EACH ROUTINE INOIVIDUALLT ANO IS iNCUUPtO FOR COMPLETENESS 
ONLY. REFER TO IT IF YOU kISh TO HAKE UP A MACRO IMOIRECT 
COMHANO FILE rtMlCH ASSEMBLES ONLY THE SOURCES FOR YOUR 

HACRO INDIRECT fILES APPEAR OH MONITOR SOURCE T*PE 3 
^J* fO" l«'/«a SYSTEMS. AND EACH SOURCE TAPE FOR ia/« SYSTEMS, 

"l^ *l.U WITH EICTENSJOM '',CCL", THE XXxHL«.CCL, XXXHt.S,COL. 

*}: If^J^^t* •''£'•/ "-ES PRODUCE JUST BINaRY F!»6m SOURCE TAPES 

*}* *'S"*. THE XXXBTH.CCL FILES PRODUCE BOTH BINARY ANO CREF 

*JJ INPJT FROM ALL SflURCE TAPES, S5*RLX,CCL ASSEMSUES ALL 

Vl| SOURCES FROM USK AND PUTS BINARIES OM OSk , IT IS 

Vl« THE RECOMMEND HAY IF YOU HAVE £f|OUGH DISK SPaCE<50B0 BLOCKS). 

MORE THAN ONE FILE IS REOUIREO BtCAUSE OF THE ouut-RS'. 

LIMITATION OF Zi FILES ON A UECTApE AnO THE OESIRE TO 
BE ABLE TO ASSEMBLE BINARIES wITh juST 4 OECTAPES, 
THE FOLLOHING CHART SHOWS THE DEVICES MEEDEO IN 
OBULR TO PERFORM THE ASSEMBLY, 





Pitt NAME 


RtL 


LST 


«DT* 


vli 


S4 


rtU^'i 


.CCL 


y 


MO 


3 


V14 


S>4 


nTh 


.CCL 


Y 


¥ 


7 


V14 


S6 


.Mi.fi 


.CCL 


Y 


MO 


S 


n4 


S5 


3Th 


,CCL 


y 


y 


ii 


V14 














vlfc 


siePLx,( 


:cu 


y 


N-0 


V 
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#KTA INPUT OUTPUT 

3iN NL.N 

t 3-6 Rt4|RL»«RL»iM 

e 3,N R^N 

t 3«6 RL4|Rt5iRL«iM 

t4.15 BLX4|RUi!» 

e OSK DSK 

THfL IMJlRtCT FILES HAVE BEEN DESIGNED SO THAT A DISK 
IS wOT HEQUIKED* HOWEVER THE ASSe'^BLY PHOCESS CAN BE 
SPta UP BY COPYING Some or all of the SOURCES ONTO THE 
DISK AND PUTTING THE BINARY ONTO THE DISK, 

ALL OF THE FILES EXPECT THE FOUR MONITOR SOURCES TO 
VI* APPEAR ON LOCICAl DEVICES 3,4,9,6,14 ANO 15 RESPECTIVELY! 

V14 SEC LISTING OF TABLt.TXT ON MONITOR SOURCE TAPE 3 

FOR DIRECTORY LISTING OR CONSULT THE DECTAPE DIRECTORIES 
THEHSElVES, THE BI^ARIES ARE PUT ON LOGICAL DEVICES 
V14 fiLt» RlS, HL6. RLK AND HlIS, UNFORTUNATELY 2 DEVICES 

ARf. REQUIRED SINCE THERE WILL BE ^'ORt THAN 22 eiNARV FRES, 
THt CREF IfiPUT IS URITTEN ON LOGICAL DEVICE M WHICH MUST 
BF A MAGTAPE UNLESS YOU HAVE A VERY LARGE DISK, 

IF YUU HAVE A DISK THE GREATEST SAVINGS CAN BE ACCOM* 
Vl4 FLISHED BY COPYING ALL OF MONITOR SOURCE TAPE 3 

V14 O'vTJ THE DISK AND ASSIGNING DSK ThE LOGICAL NAME "3", 

TUIS IS BECAUSE ALMOST LVERY ASSEMBLY MUST READ S,HAC 
AfiO ABOUT HALF The APPROPRIATE FEaTURE FILE ON LOGICAL 
V14 DEVICE 3, IF YOU HAVE ENOUGH ROOm, YqU CAN COPY ALL 

V14 6 TAPES OF THE MONITOR SOURCES ONTO THE UISK ANO 

Vl4 ASSIGN The USK AS LOGICAL DEVICES "3","4",ii5",»6","l4<«, 

Vl4 ANO "IS", 

V14 SECTIONS 3.1,2 Through ^,1,6 describe how to use each 

OF THE EIGHT CCL FILES TO PRODUCE RELOCATABLE BINARY 
ANO/OR LISTINGS OF THE MONITOR, 

Vi6 3.1.2 FILE SSiRLX.CCL Will PRODUCE JUST MONITOR BINARY 

Vl6 FILES FOR A li-VSU SYSTEM WITH A DlSKlSBB!! BLOCKS NEEDED), 

Vl6 NO 3ECTAPES ARE NEEDED. 

V16 3,1.2,1 COPY ALL MAC FittS ONTO DISK, (USE FAILCD LOOGEOsiN UNDER 1B|7). 

Vl6 3,1,2.2 TYPE I 

V16 ,R NACRO 

V16 

Vl6 »S5IH,l» ,CC19 

Vl6 
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J.i,3 Flut-S. 5*2SL'i,CCL A^iO StiriHUi • CCL li«"!«L6,CCL wJLL PRoUUCt 
OUST '<ONITO« ■5I^A=^V FILE.S FDR A \./m 
VI* SVsTfi iiflTh i DECTAPES, 

i.l.J.i TYrt 

VI* AS&I;.', UTA 3 

VI* ASblCi'J UTA 4 

VI* ASiICi UTA '<L'» 

TO A'vY TIME SmaNIMC MO'NJTOH, THt 10NIT0« WILL SESPONO 
U'lTH THt PHYSICAL DEVICES ACTUALLY ASSICNEO, kOUNT 

VI* ><0MTOR SOURCE Tape 3 on logical unit "i«, 

VI* HOMTOH SOU»CE Tape 4 on LOSJCAL U^-1T "4", 

VI* AND A sLANK Tape o'j logical u^jit "«l4", make sure 

VX* "3"« AivO ■•4" ARt ^RITE LOCKtO ANU THAT "HL4" IS SET 

VI* TO «/RlTE, 

3.1i3.2 COPY TmE ecu FILE ONTO "HL4"I 

VI* ,R PIP 

Vl* •Rl4i/?«-DTA3IS4Brl4,cCL/B/X 

Vl4 •<i;0~jTROL>C 

3.1.3.3 ASSEMBLE SOURCE TAPE 4 
PY TYPINGI 

,H ■^AC'iO 

TO THE «0N1T0R, FOLUOhED BY I 

VI* RL4!S42HL*,CCl* 

FOLlOWEg BY A CARRIAGE RETURN TO kACRQi WHERE 9 JS TME 
"EACH" SIGN (NOT ALT-MOOt), THJS WILL CAUSE MACHO TO READ 
VI* COMMAND FILE S4«IRL*.CCL, IT WILL TYPE OUT THE TITLE OF 

EACH PROGRAM AS IT JS ASSEMBLED. IT WILL PRINT THE NUMBER 
OF ERRORS ONLY IF IT FINDS ANY (WHICH I T SHOULDN'T) , 
WHEN ALU THE ASSEMBLIES ARE COMPUeTEi MACRO WlLU PRINT 
EXIT ANQ THE TELETYPE WILL BE RETuRNEO TO MONITOR MODE, 

3.1.3.4 LIST THE DIRECTORY OF LOGICAL DECTAPE '•HL4«, BY TYPINGI 
,R PIP 

v14 •ttyi»rl41/l 
•<control>c 

TO THt MQMT05 ANO PIP, CUT OUT AmI) Ta^E THE DIRECTORY 

VI* ON The unit RL*. 



vl" 



Ul4 



Vl" 
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/.1. 3,' nt 'JVL tOuIC^AL IJECTAPE "KL4", >AuU^T 4 SECcKO 
cLfi- TAPE !^N LOGICAL UNIT "Rl"" 

^.l.J.'i Tf-'tU T„L .-.l,' IT0« THAT TOU HAVE MUL;Mt,) VEW DECTAHES BT 
TVFl.u TmE tSSItN COHMANU FOR EACi. PHYSICAL UWIT, THIS 
I'S prii^TA-JT! IF YOU UO NOT 00 TuISi THE h'OMITOK ulLL 
ubl. Tht JlHECTOKY IT HAS IN CCHE r^ATWE- THA^ T^t Oil OK 
TAI u , 

[.X'.-irLt.l ASSiJME THAT THE MONITOR HAU aSSIgWET PHYSICAL 
DEUCE UTA7 AS LOGICAL UNIT "RL*". 
TVf-t 

ASilG , JTA7 Hl5 
51'lLA^LV, ASSIGN "5" ON THE DRIVE USEH FOR "4", 

i.1.3,7 nLlt-AT STEPS 3,1, J, 2 THHOUCH J,l,3,& FOH EACH TAPE 
TO rft ii£EM6LFD. 



M0NIT'!,QPR-£.2 
PAGE 142 

.?,1,( MLi- i4..'iiTH,CCL WILL PHODUCE HCTh MC!.ilTO» PtL C^tLOCA- 
TA"LL r:lNAf)y> riLES AmU CwLF I-Out I^ "ArtAulLL f DH A 
Vl" I,"/:* SYSTf' ..Slha A lir;/«,« SYSTtM WIT.J l maCTAPL AsO 7 

'jf-l an I 5, 

2.1.1,^ .-;h Tr-t. .-lOMTlW A-isIi^N (;0.ii'.A.i!jS T:; 43311,?; .-;Evt:'. DEcTAPf. ulTl- 

Vl? U3iICAL f.A^fcS "i"."4>t,"3","6", "KlA", "KL5", A.',u "RL*"! 

VI* AL'u 4.;bia\ A iAr.T4Pr "y", mCj,,,! ■iC ar-'? S-'MfiCtS 3,4,'i, 

VI* ANjO t i.N LOGICAL iJ^-ITi ".S", •■'!", "b" , A^in '-6" A'^t t-LA^;K 

VI* CECAPtS OK LTGlCAL UMTS "RL"*". "HL'". ANn "HL6", CLtAH 

Vl* THE UlatCTO«lES tl:>l "BL*"! "RL!»" A,vD "^L6" USpG^FIP AND 

VI* COPV Sa.-KTH.CCL ^«tj^■ LOGICAL U:-.IIT "3" TO "KL4", 

VI* POTlATt the: iSbE.-i»LV HKOCLSS at TYPIjr.t 

,R -lACKQ <CfJ> 
VI* •RL*IS«f.BTM,CCL''<CS> 

VI* 3.1.5 FlLtS SSi5RL4,CCL, S6«f<LS,CCU AnO S6;fRL*.CCLi ETC,. W[LL 

PRcUUCt JUST 3£L (RELOCATABLE SINaRY) rOH A a,0/SC 
^YS.Tt^ USING EITHER A li«/4i(! Of* A IC/S;' bYSTEM »iITH 

VI* ,5 nLCTAPES, 

3,1.5,1 TO ASSEMBLE T^t MONlTOH WITH JUST FO'-R UtCTAPES PROCEED 
AS FOulOkS: 
VI* .ASSIGN DTA i 

VI* .ASblGv UTA 4 

Vl'^ .AESlG'i OTA Rl* [MAKE LOGICAL ASSlG'vMEfTS cORRt SPONO TO ,CCL FILES] 

VI* CCJ'T flOMTOR SOJRCES 3.4 ON LOGICAL JNJTS "3"."*", 

MOUNT A eLA^K DtCTAPE ON LOGICAL u^IT "RU*" WRITE ENABLEDJ 

Vl* •RL*</?»*lSSe'RL*,CCL/a/X [COPY CCL FILEJ 

• <C0jTR0l>C 

,R MACRO 
VI* •RL!IS5WRL4,CCL» tINlTlATE FIRST P0;JTI0N OF ASSEMBLIES: 

Exii" [MACRO terminates: 

,R KIP 
VI* •TTYl-HL*l/U CLIST THE DIRECTORY OF UNIT "RLl"] 

•<C0nTROL>C 

Vl* .ASSIGN DTAN HL9 CWHERt DTAN IS PHYSICAL UNIT ASSICNEO TO "KLl": 

[RE'iOVE TAPE FROM RLl. ATTACH IT<S DIRECTORY AhO MOUNT A BLANK ' 

CECTaPE on »H4T is NQiJ LOGICAL U^IT ftL23 

Vl* REFtAT ABOVE SUBSTITUTING "Hti>" f ilR "RL*" 4^;0 "»" FOR "4" 

Vl* REPEAT AGAIN FO** EACm TAPE, 

THE FUlL0*1mG INSTRUCTIONS ASSUME THAT YOU HAVE A DISK 
Vl* .HICn i.lLL HOLt; AT LEAST mqnitoR S'Hi'^cr TAPE 3, 

«!EKO iJlSK DIRECTORY, 
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■i.l.'^.i C'll T.jt MAC riLES (n< MUNITCh SOO-iCE TAPE 3 TO 
THL JISK BV TVPlMG 

Vl" ,AbaI&« DTA i 

Vl« TO Tttt MCiNITljh »NJ .■'.()t.Ji'TI\t, HiJIUTtX SjCmhCE TAPt 3 ON 

THt PHYSICAL. V-n THE MQNITOH ASSl&lLO, 

TV1--E 

,R PIP 

TO THL MCNITps KoULOi^Eb bV 

\ii^ •ObH!/X/B»3l»,M*C 

TO PIP WHICH .!II-U CAUSE HI" TO THiNSFER ALL Or THE FILES 
1«IT1 EXTENSION. .MAC TO THE UlbK, THt /X SWITCH CAUSES PIP 
TO HETAlN THt SAME .'JAKES Qn ThE L'ISKi nATHE" THAN 
COMBINING ALL OF THE FILES INTO C-E, THE /fl SwITCh MEANS 
COPT I\ BIfJANV AKiQ ShOULO AL^aVS jE USED WHEN COPYING WITH 

\il1 /X AS k hAbIT ijtCAUSE t-ITHOUT IT, PIP OOUBLES T^tE LENGTH Of YOUR FJLE 

I.Hl." GOING FROJ< DISi< TC UECTAPE, USpJC THE /S SUITCH 
IS ALSa A CC03 HAaiT SINCE YO.i Nt^tsi HAVE TO MC«RY ABOUT 
1.HITHEH Tut UATA IS KEALLY BIjARY OH '-OT, 

S.l.b.S COPY AS MANY fiF THE TThEH .tONlTOR SCIUBrES ONTO THE DISK kS 
Vl" YOt. HAVE HOUff FOR ALTrtUUGH JUST TaPE 3 GHEATLY INCREASES 

EFFICIENCY A3 SiMAC AND THE FtATURE FRES ARE CN IT, BE 
SURE TO ASSIG-. ThE DECTAPE UNIT bEFoRE MOUNTING EACH 
VI* TAPt, AT LEAST THE CCU FJlES MUST BE COPIED To DISK, 

3.1.5.4 FOR EVERY MONITOR SOURCE TAPE THAT YOIJ ARE GOI'>jG TO LEAVE 
ON T4E OECTAPE DRIVES, MAKE SUKE THAT YOU HAVE GIVEN THEM 
VI* THE APPROPRIATE LOGICAL NAMES •'4","S", AND "6", ETC, FOR 

EVtXY TAPE YOiJ COPIED TC THE USK TYPf,! 

Vl* .ASSISl- DSK S 

Vl" .ASSIGN DSK * 

Vl« .ASSICfi DSK & 

VI* .ASalGv DSK 6 

vl* ETC, 

IT I'i POSSIBLE TO GIVE THE UISK ^•i^•v LOGICAL NAMES 
SlhULTANEOUSLY WHILE EACH DECTAPE CAN MAVE ONLY ONE 
LC(.ICaL name, if HOMTON PRI.-TS I UT logical name ALREADY 

r 'JSE, DEviCF xxx assigneo, first iea«sicn old name 

VI* (SiY IT KAS 3) BY TYPING 

Vl* LE-.jaIif< 3 

f iTLL ".i.0 BYI 
V1-* 45' 1 >'. USu 3 

CT.-LT-.1SE Y^jUR LOGICAL MA-L WILL rit Fo« A DEVICE YOU DID 

: rr I -iTENU, 
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3.1.5.5 riNALLY GIVE THt DISK THE UOGICAU "JA'IES RL4, «L»i ALb. ETC., av 
TYf JNGI 

Vl< .ASSIGN OSK RU4 

VI* .ASSIGN OSK RL5 

VI* ,A£.SIGN DSK RL6 

Vl* ETC, 

Vlf (1ACH0 WJUL -RiTt THE ^EL, riUtS 01. DEVICES "Sl.4'>, "RtS" AND "Htb", 

3.1.5.6 PERFORM THE ASSEMBLIES BY TYPirgji 

,R MACRO<CR> 
Vl« •S5('H|.4,CCU»<C«> 

l»lkCHO TYPES PROGRAM! JAMES] 
EXIT CACRO NOTES TERMINATION] 

,START<CR> 

Vl« REPEAT FOR EACH TAPE, 
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Vl4 3.1.5 FILE. St>aBTN,CCI. PRODUCES BOTH REI. tRE|.OCAT*BWE BJNdRY) 

VIX riut-S ANU A CREP l^PUT UlSTINC FiLt FOR * t»^»t SYSTEH 

Vll USI-^G A l*>/4fc} OR « la/&i» SYSTEM HITH 1 K*6T*^E »"iO 

VI* 11 DLCTAPES. IF rOU DO WOT H*VE A OTSK PROCEED *S FttitOWt 

Vl* ,Ab"SIGf« OTA i 

Vl* .AbilGiv OTA « 

V14 .ASblC'v DTA 5 

Vl* .AoSlGK UTA 6 

Vl« .ASSIGN DTA 14 

Vl4 .ASSIGN OTA 15 

V14 .ASSlG^v OTA Rl.4 

VI* .ASSIGN DTA «l!> 

Vl* .ASSIGN OTA Ru6 

Vl4 .AsSJGV DTA RlI* 

Vl* ^ASiilCN DTA RH9 

Vll .ASSIGN HTA H CASSIGN HA.6TAPE FOR tlSTjuaj 

VI* [MTUNT MONITOR SOURCES 3r«»9|,»,t4,tS ON tOtlCAL Ul»tt» "5","«"«"f","t»,n«","l»"i 

V14 KOi,'*T PtAlvK OECTAPES in tOCICAL UnJTS "Ht«",'»8t>*,''l»t«"»''l«l.l*''»"l«U9"t 

Vll MOl/.T A BtASK HA6TAPE W-JTM THE HHrTt RING JN* 0» THE 

Vll FHVilCAL MAGTAPE THE MONITOR ASSUMED TO YOU,} 

Vll .R flP 

Vl* »f)i<H-/i 

vl* »fliit»/i 

Vl* <nii.bl-/i tCUAR THE DIRECTORIES OF UNITS "RLi^r'ULS", 

Vl* •f»Ll4t»/2 

Vl* •HLlS!*/? 

V14 •''L4t/x/B«-3IS5£BTH,CCL CCOPY SMBTH.CCt TO "Rti"? 

vll •<CJ'''iTSOL>C 

Vll ,tt HACRO 

Vl4 •RL*IS5eBTH.CCL» tSTART THE ASSEMBLY M0CESS3 

Vll Ir^uliiiO KILL TYPE EXIT HHEN IT HAS FINISHED ASSEMBLING AND 

Vll Li5>Tii<G THt Entire momtorj 

vll IF You 00 HAVE A DISK COPY AS MA^Y OF m0K|T0« 

Vll SCli^CES TAPES 1 THROUGH * AS KILL FIT ON THE DISK aNQ 

Vll GIvt THt DISK UOCICAL MAKES CORHtSPONOlNC TO THE SOOKCE TAPE 

Vll NU'BtRS RATHER THE OECTAPES AS ABOVE, THt DISK MAY 

Vtl ALSO BE USED TO RECEIVE THE REL FILES 9Y TYPING 

Vll .ASilGM OSK BLI 

Vl* ,ASaIG:i OSK HL6 

Vl* .ASSIG^ OSK RlI* 

Vl* .ASSIGN OSK RL15' 
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i,i,7 «S?-.tM!JLL HO-IinW SOURCES 3r ha;-.0. jSV^Q M*C"*0 

CICUUOEC »ff*E fOR 'CC>^•PLtTt^ESS Cr.LV 'SFE SECTION 3,1.1 
TU-(iuGn 3,1.6 fOR AUTO^•AT:c ASSEl-'tL* TP L'JTHE MOMTQHJ 

>i.l.7,i :E:-.i,i»IrJT]ON or '^OMTf)!' SOUI^CES 

TWf.L i.Ht UVLH a? I'AC'^tJ bCuS'CE FiLtJ TO TrtE CCmPlETE 
"OiJTOrt. SO'lt OF THE FILES ;-iAY tiE ASSEMBLED Bv THEM, 
SELVES Wi<lLt TTHfRS MUST RF. ASSEMSLEO »1ITH A SYSTEM 
SV/'isOL UEFIVITIOn file CALLED S.MaC 

wITHl?, S, CESTAiN SPECIAL SYMSOLS AHE OEFIriED TO HAVE 
THE VALUE !■■ OB -1. These values CO^Tshl The ASSEM9LV 
OF .tHTAJN FEATURES I J THf. mqmtOR, THESE SYMBOLS ARE 
CALLEO KATUHE SWITCHES ANO ALL bEGTv nITh THE LETTERS 
FT, IF A S-iITCH IS ASSIGNED THE VALUE -1, THE ASSOCIATED 
FEATURE UILL APPEAR IN THE ASSEMBLY. IF ASSIGNED THE 
VALUE i, THE FEATURE WILL ;mOT APPEA"?, SEE LISTING OF S.MAC 
FOR A DESCRIPTION OF EACH FEATURE, 

Fluts ASSEMBLED WITH Tht VtHSJON OF b.MAC SUPPLIED "ILL 

CONTAIN THE Full duplex feature, iM o«der to remove 

THE FULL DUPLEX FEATUWt, I,E, PROQUCt A HALF-DuPLEX 

VERSIOf. OF THE ►ILES, IT IS MECESSARY TO SET THE SWITCH 

FTCCL = /^ THE VALUE OF THE FEATURE SWITCH FTTTYSER»B, 

THJS HAT BE QO-Mt ^ITH TtCO, .-IHEN ASSEMBLING A HALF DUPLEX 

LIBRARY. IT IS NECESSARY TO SET TwE SWITCH FTCCL«iS JN 

fTS'.S.MAC IF IT IS REOUIRED IN THE ASSEMBLY OF YOUR PARTICULAR 

COtFIGURATICN. 

SOr-t CF THE FILtS MUST BE ASSEMBLEU WITH BOTH S AND AN 

APPROPRIATE Feature symbol definition file which controls 

COhOlTIONAL ASStHSLV OETERMINEU By WHICH OF THE 3 SYSTEMS 
IS BtlN'b ASSEMBLED FQR, EACH FILE COf^TAINS FEATURE 
SWITCHES WHICH SPECIFY WHICH Of ThE i POSSIBLE SYSTEMS 
ARE TO BE ASSEmSlE0,3 THESE FEATURE SWITCHES ARE IN 
SEPASATt FILES CALLEOI 

SYSTEM FILE NAME 

A ■•i FT<tN..MAC Xi/*£ ,\CN-UISK 

VJ} 4-0 FTAra.MAC Xi/AJi OiSK (ALL TYPESJ 

V*l -.0 FTS.'b.MAC liJ/iii Si.APP]'!C (ALL DISK TYPES) 



kOMT'*.OP«-BZ 



(CO-n-.l 



t xcLi >(. no'. or System namlm 

T^. U i^T i tMAKACTt-HS SAV -HfcTHt-W THr SYSTtM lb NQN- 
...st'l'l ^0 (4 ) ilH S.APPINIi (S^) 

^■A\ T.<IHJ C-^A^^CTT'^ SAYS -iON-jlSn fJl. fiON-SKApPING 
■ I ^^ ( ,) , 3' ADClNjG (S) 

•,(, THE HtOUIREJ SOURCES, THE RELOCATABLE 
ILES tilST BE COH.-ItiFrj ImTO A LISKARY 
SO That ThtY MAV cE L^A 'LD IjbJNG THE 
bfFOBf ASStMrtLINC THE Sf^rjITrjR Tiit USE« 
LTher HE -lA'vTS rULl OR HALF OUPLE" TELETYPE 
COmHE'-D full duplex BECAUbt IT ALLOWS CCL 
S A-JO HAS MAHiY uyEx CO'iVtN I ENCCS , THE 
ANNOT HF made TiJ HAiOLt i-QTH TYPES T0« 

,G n\ mongen: a'js«er So the OEClsiaN- must 

ASSf-IJLY, The FOLLa^r'G INSTRUCTIONS 
LlN5 FC!« 1 OF i LltoASY rjLESl 

LII.i=JAHY FILE fvA-E 



.'.FT 


' i. ••. A 


aSEM^LI' 


-I 


A'<Y( 


,1-tL) F 


Ml, 


(L l:: 


1 4G »|P 


-.f!. 


i'JLA'^ 


lcaje^- 


■•i.l' 


:T OL 


LIDE WHI 


;>?_■■ 


.vICl, i>E KEi 


r- 


JI:..-- 


SYSTE'-: 


Ll' 


-X A n y 


hlf c 


^,LTML'; 


■iKVi. iUI 


:-F 


'i^Llf 


"LFO«t 


; ■■ f 


t ;- 


JSSt'H 



vll 

\.1J 



&' Xx.KEL 
iJXX.KEL 

bSxx.KEi. 
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TNt. „or.H MUST ntClDt -HJCih OF THt »«!,''.'> T:<^E£ FILES HE 
1. IMtS TO CWtJTt IF ME IS C^tiTr,- i vi'^^ LIPi'A'^Yj 
')!►■£« ->! St, fit '-AY lEKELV nfTE:^Ml..F TNf SYSTEM 
I LSI,. .,<T10'v F ■'fc HI3 "LXliTl.U LIURASY" ^lll FHOM THE 
AHGVE TAtiLE. 

ALTH0ut.r1 IT IS FQSSIaLE TO ASSLMblE. PIP, AND LOAD A 
!-:D.MTO'< wITt* JUiT 2 DfcCTAPES PLUS A CJSP TAPE TH£ 
FOLLOWING OIWECTIONS ASSUfiE ThaT tMERf ARE Ti^O UMTS 
FOf. Srji'HCES, QM. FQH PI'MABy, J^D 3ME SCRATCH T4PL FOf« 
CHEF I.TEHMtUlAlE OUTPUKIF LISTING UESIKEO), PLUS THE 
CUi^P TiPE, 

"Ou JT JiQNiTOR SUgSCE T*Pt J OM U^IT iJlTH LOGICAL NAME 3 
Al'Mj rIOi-ITOR SquHcE Tape < on U^IT with LOGICAL NAME 4, 
-lai.iJT TAPE TO RECEIVE BINARY FILES ri\ UNIT MITh LOGICAL 
'.Aft .'<L», IF YOU HAVE A DISK, COPY S.VAC AND 
FT ,(-AC FKai 3 TO USK USING PIP! 

.R PIP 

•0SKI/X/b»3IS,M*C,FT -,MAC 

• ♦C 

AMD IS The following ASSEMoLY INSTRUCTIONS SUBSTITUTE 
OSKIS,FT- FQH 3tS,FT 

DURING THE ASSEMBLIES. SUaSEQJENT SOURCE TAPES S,6,14, AND 15 
»IILL BE SUBSTITUTED FOK 4, HQWEVEF* boUHCE TAPE 3 MUST ALWAYS BE 

PRESENT UNLESS THE FILLS S, AND T-,E OESIRED FT FILES ARE 

COPIEO FROM SOURCE TAPE 3 TO SOURCE TAPE 4, 5, 6, X4, AND 15 

OR YOU HAVE A DISK, SINCE THEY ARE RE-REAQ FDR EACH 

ASStMBLY, COPYING ALL OF THE OTHER SOURCES ONTO THE 

DISK REDUCES THE ASSEMBLY TIME FRflM kii MINUTES TO ABOUT 

Id MIMUTES ELAPSED TIME, SO IT NEED BE DONE ONlY IF 

YOU HAVt A LOT OF DISK SPACE, FOR EACH ASSEMBLY, THE USER 

SHOULD ALTERNATIVELY RUN MACRO ANq C^EF, OF COURSE 

IF The user opes NOT WANT A CREF(CROSS-REFERENCE) LISTING, 

HE 'lEED ONLY SUN MACRO, HOWEVER, THE INSTRUCTIONS ASSU'-iE 

THAT A CREF LISTING IS V.ANTEU F 0" EACH SUB-PHOGKAM OF 

THE '■^OilTOR, THUS THE PATTERW OF TYPE-IN iSl 



(CONT'D) 
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,R 'lAC^O 

• ftL'tl i/C*-JlS»FT— -» — 

CSOMETIMES S IS OMITTED, MOSTLY 
FT—— IS OMITTED] [MACRO PUTS CREF 
IHTEKMLDIATE ON LOGICAl, OEVICt OSK 
WITH FILE NAME cRE'^.l.STi IF cHr IS 
HOT RUN, OMIT /C BUT INCLUOE "i"] 

THF-^E ARE NO ERHOS 

PRDGKAM BREAK JS — 

-K CoRt USED 

(IiiJiTHUtTlONS ENCLOSED WITHIN < > OMITTED JF NOT RUNNING 
CREF) 

< 

• »C 

.R CHEF 

•CUstH TYPES JUST CARRIASE RETURN WHJCH CAUSES CHEF TO 
REAU FILE CREF.TMP FROM LOGICAL DEVICE OSK ANO PgT CREF 
UlSTIMi. ON LOGICAL DEVICE LPT] 

'K CORE 

«tC 

,H lACrtO > 

•[ itXT FILE TO BE ASSEMBLED, ETCJ 
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COMMON 



THf KE:AS0\ TH4T MACRO *fjQ CRtF AKf -IJK At.TE*.>iATE|.Y , 

IS T!] -^tOiJCi T>^L AMOiJfJT or CHtf 1 .TEW-/E g [ * yE STOfiAGL 

SE^UlStU, IF i uSf? HAS A -1A-,,TA:'L, jr CA\ PUT AUL THE 

C^fl- r-iTESMt,iJl»TE C'l MAGTAPf. ^lY i^'j^-.l-si 

HUIti. FIRST, rOULOhEO bY AtU T^t c^fF'S 

FOt- .'UCH LESS TYPllvC, SINCl TriEKt IS ■;'> 

COI TROi. c FOLLOWED BY A Mpr.;lT,)S C"»Vi4>iD 

ivHE'v The CfiEF's A«E 'iUiM The USER t-FJ^EuY 

HET.JR.V AS IfjPUT TO EACH ASSEMBLY CUTK-JT USIlilC THE MAG 

TAPE A3 INPUT AND LPT AS OUTPUT, 



ALL TrJt ASSEM- 

ThIS f.AKES 
.^EED TC TYPE 
ON EAC»- ASSEMBLY, 
TYPES CARRIAGE 



KO'.lT(l« COM»IA\,OS| 
ASSlt.;. UTA 3 
tiTA^V ASS1G->IED 

ASEIGM UTA 1 
i■TA^l ASSIGNEC 

aSSIG;^ UTA DSk 

ufi't ASSIGiiEO 

ASSIGN UTA SL4 

DTAii ASSIGNED 

,S PIP 

•os<f*/< 



LSOURCE TAPE -53 

LHONITCjr ASSIGNS DTA »!-. WJTH 

LOGICAL 'JAMr Jj 

[SOURCE TAPE OJ 

[MONITOS ASSIGNS TAPE HITH 

LOGICAL NAME. 4] 

LMAC^O jMEi^MEUIATE OUTPUT, 

CHEF INPUTJ 

CMOMITO^ ASSIGNS OTA WITH 

LOGICAU fVAMt OSKJ 

tSHAHY OUTPUT FROM fiACROJ 

[MONITOR ASSIGNS TAPE WITH 
LOGICAL NAME HIN3 
[Run PIP CUSPJ 

CCLEAR CIRECTORY FOR BINARY] 
[CUEAR DICE-CTORY FOR TmP LISTING 

(IF NO ois<n 



COMMON DATA STORAGE FOR MONITOR 

CONFIG CONFIGURATION QEPENOENT MONGEN 

DIALOG OUTPUT 
COMMON CONFIGURATION INDEPENDENT MONJTOR 

04TA AKEA 
[AL-^aTS REQUIKED] 

[APPEARS ON OECTAPE HI*, SINCE IT CQrvTAlNS ALL THE 
EXTERNALS WHICH 
LOAD THE PROPER DEVICE ROUTlNESi FQH YOUR CONFIGURATION} 



ALL) 



RL^IC0MH0N,FJH|/C»IS,C0wFIG,4ICaMM0N 



Vll 
Vll 
Vll 
Vll 
Vll 
Vll 



BTHINT DATA LINE SCANNER ♦ COMPuTEH-COi'PUTES-INTERFACE 
DEVICE DEPENDENT PART OF TELETYPE SERVICE 
[ASSEMBLE OvlV IF aOTH 0C1» AND DaIB ARE PART or 
YCUH HAROinARE C0NFIGURATI0N3 



ALLI 



RL<fBTHINT,/C«'i|S,4|HTH!NT 



mONITSiOPB-BZ 
PACE iiX 



(CONT'D) 
CCIInT 



CDPSEH 



COfiSCiX 



CDRSR6 



CUOCKl 



Vll 
Vll 
Vll 

CLKCSS 



Vll 


tlNI 


Vll 


«iOl 


vll 


SeSltNEVER] 



COilPuTEB»COMPUTER"INTEHf*qC • DEVICE 

DEPENOENT CART OF TELCTrcC SERVICE 
[.ASSEMBLE ONLY IT CCI IS PART OF HARDWARE CONFICURATIOK} 

ALLI Rl4lCCnNT./C*9iS>4lCCIlNT 

CARD PUidCH SERVICE CCP«1»> 

CASSEHBtE ONLY If RaRT or VOuR CONrUURATION] 
J^ULI Rl4|C0fSER«/C*?|S.4iC0RSCR 

CARD READER SERVICE ROUTINE rOR POR-ll 
tCR-ti) 

CASSCMILE ONLY ir CART or HAROUARC CON* 
riOURATIONj " 

AULI Rt4IC0RtRX|/C*>lSi4te0RSRX 

CARD READER SERVICE ROUTINE rOR COR>« 

CASSCMiiE ONLV ir Cart or haroharc 

COturiCURATION} 

AtLt RL4IC0RSR*i/C<>SiS,4tCDR$R» 

CUOCKfCONTEXT SWITCHING AND JOB START 
AND STOR ROUTINES 
^PSINT HIGH RRIORITV RROCCSSOR INTERRUPT 

ROUTINE 
CLOCK LOW PRIORITY CLOCK INTERRUPT ROUTINE 

RUNCSS ROUTINES TO START AnO STOR USER JOIS 
tALWAYS REQUIRED] 

I^NI RL4ICLOCK;i/C»|lS,rT4BN,4ICL0C)<l 

4-10 " •3|S,rT4f0,4ICL0CKl 

>aSl " •.3|S,rTSiS,4ICL0SKl 

JOB SCHE0ULIN6 ALCORTIHm rOR NON.SWARRINC 

I. El I Xe>4S, SYSTEMS (REOUIREO roR NON 
SWAPPING SYSTEMS ONLY! CUSCS FEATURE 
SWITCH rTOISKJ 

RL4ICLKCSSi/C*J|SiFT4ilN,4ICLKCSS 
" •J|S,FT4IJ0,4ICLKCSS 



(CONT' 


C) 




COMCC.> 


1 






COmCON 
CO'<CSS 
SAVGtT 


tAL« 


Vli 
Vll 




■5 "ri: 
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ca.-iMAWD DtcnotH amu iAVjti ar'UTiNEs 

r-OfJiTOR COM^iA^D l-.tCCOE" 

CO-ViO"" SUr^HOUTIf.f S JSEu >iV ""MToR ^^"►^A^OS 
TMt SAVE AMJ ttT MO-!lTD= CO'<"ANDS> 
tAL^ArS .<tjJIKEOJ 

'• »4!5,H4.JU,4IC0>'C0N 

COHtl COKE ALLOCATION A,-^0 SHUFFLING 

C*Lt*AYS REflulHEuJ 

Vll 4..:m| HL«lC0KEi,/C«-3lS.FT4;»N.4!C0REl 

Vll 4 Di " «-3l3.FT4fDi4!C0REl 

Vll 5-3! " *JIS.Ft5eSi4lC0REl 

OCSInT data COMM. SYSTEN - DEVICE OfcPt\DENT 

JVT, StRVt (PDP-fc 63S?> 
CASSEMBLE OmlY IF PART OF HARDi«A''E CONFIGURATION: 
ALL' 3LA!DCSI»;Ti/C*'liS,«tOCSINT 

OISSEH TYFE i*i JlSPLAY SERVICE ROUTINES 

CASSEHBLE 0\lY IF PART OF HaRDWaPE CONFIGURATION] 
AL« «L*IDISSEHr/C*?»Sf4lDISSEP 

OtSjNT 'jATA LINE SCANNER - DEVICE DEPE-jDENT 

INT, SfcRV, FOR USE HITH TELETYPES 
CASSEMBLE ONLY IF PART OF *^AROI«AHE CONFIGURATION] 
AULI RL4IDLS1NT,/C*3|S.4!DLSINT 



MON1T'',OPR-B2 
PACE CSS 



(CONT'^r.) 



JTASR UtCTAPE StRVICt F0« PUH-l*!! TU-95> 

OECTAPES, (SjEH FORHaT) 
[Assti^bLt O'lLf IF PAHT OF HAROt-APE CONf" I CURAT 10N3 

< ,,; RU5(DTAStN,/C»3!S,FT4ZN,5IOTASRN 

4..0( " ^T4ZD 

S.SI " fTSMS 



uTCSv4 UECTAfE StRVlCt FOR P0H-6(955> DECTAPtS 

i-ITM PDP-1«I COMPATIBLE FlUE STHUCTUREi 
CAaSt«BLE 0\LV IT PAWT OF HARDWARE CONFIGURATION AND 
.ti^ FILE STRUCTURE IS UESIREO] 

4LLI RL5;DTCSRNi/C»JlS,9lDTCSRN 

EDDT LXLCulIVE MODE ni:T (QYNAMIC DEbuGClNC TECHNIQUE) 

TAIiSLMBlE 0\uV if EDOT MAYBE ><AmTED 
Ab SPECIF lED IN MOnGEN OlAUOG] 

Wl2 ALL! RL5IED0T,LAS,/C*SIE0DT 

E.R«CnN . ilTOK OETECTEO ERROS t-iASSAGE rtOUT[M£S 

LAl»aYS HEJuIREDJ 

Viz aLUI RL5lERHC0N,/C»J|S,&iERHC0N 

jOdOAT SYMBOL ULFI-MlTlOtjS FOR JOB DATA AREA (BOTH 

SUUHCE CODE AND ASSEMBLY LISTINGS) 
tAL».AYS REajHEQ] 

VIZ ALL! HL5lJ0BDATi/C*i|S.S|J0B0AT 

LPTSEI^ lI'.E PRINTER SERVICE ROUTINE 

CAiaLMBLE Q'-Ll' IF PART OF HAHO^aPE CONFIGURATION] 

\lU ALL! HL5iLPTSFR»/C»i!S,&lLPTSER 

MOVIE «CUTIi«E TO PRINT S.vAPShDT OF SYSTEM GN LPT 

LAl»aYS KEULilKED] 
VIZ "til,! RL5IMOVIE,LAS,/C-31S.FT4iaN,5«M0VIE 

VIZ 4.'D! " FT4Z0 " 

Viz 51st " FT5?S " 



P4GL ;'54 



(CO'mT;o> 



mT*SkX Ail itl SL^vICE -:.ijTI.-<t. f :■« i-OP-l ' "H.GTAPt. 

LiS^tf-fLt " (.V IF •-■m't ■:( riiKIlvjtt C'^^f Ir.UWATlONJ 
Vlii HLi-i ".I.3:- TA;i^-x,/c».}:b.?i -iTAS^-x 

>TBS;.'X , A;,TAP£ 5-.HviI;e >^OJTIvt FQH PDP-li' ^AGTAPf 

[ASSLMfil-t D?.L^ Tf- PAPT Cf HsPO'sPf CO':PIGUSATUNJ 

V12 iLLi RlJ!MTBSHX./C»i!S,f TTt«liJ,S!»^T»5Px 

MTCSR6 ; AGTAPE SEKwICE FOR PDP-6 HAiiTAPE C0'vTH0LUEf!(S16) 

CAbbtMBLE Qi-'LY IF PAKT OP haHu>«a«E C^nF IGUHAT ICNJ 

Vl2 ALL! RL5!MTCSR6i/C«-Ji;S.5!'^TCSH6 

NUWSEC uJf MV HIC-1 iiStR StGMLM .iAf<ULlNG -iUUTlNES 

tMLQJlRtC OvlY if '0 HlSH SEGME.\iT COilf MaY SF wAMTEiJ 
Ab bPLCIFIE:! IM ,•1!:l^Gt^ "!IA1,0G: 

Viz AH HtS|ijWl.SEa,/C*J(b,FT'H!!N,Sf'<JUSEG 

Vll "i i-M " FT4i31J 

VI 1 '.■ b: " FTbiSb 

ONCE OHct onlV operator julocue foh 

MONITOR START-UP 

CALxaYS REQUIHEOa 

4 <! RU5lONCE,tAS|/C*JtS,FT4£N,SlON(;E 

Vll 4"d: "Once ' FT4ao 

Vll S'SI "OmCE FT50S 

PATCi^ PATCHING SPACE 

CAL.WAYS R£auiHEI)3 • 

VIZ ALLI HL5iHATCH,l.AS,/C«-5IPArCH 

PUTSER CAUG'JHP PLOTTER SERVICE ROUTINE 

[AbStMSLE OMLY IF PAHr OF HARDWARE C^iviF IGURAT ION] 

Viz ALL! RL5IPLTSERr''C*'3(S,i:PLTSr» 

PTPSEH PAPt-i TAPE PUNCH SERVJCE ROUTINE 

[ASSEMBLE ONLY IF PART OF HAROi«ARE CONFIGURATION: 

Viz ALLI RL5lPTPStR,/C»J|5,5|PTPSER 



PAGE ess 



<CO'-lT'u> 



PTRSL« K4Pt« T»PE REAOE" SERVICE HUUTIViE Fq"? POP-ia 

1 ■< Pje-6 [ASStMBUE ONLY IF PART OF HAHUWAHE CONFIGURATION] 

Vt2 ALL! H1,5IPTRSER|/C*3|S,>|PTRSER 

PTVssf tStUOO-TELETVPE SERVICE ROUTINE FOR FULL 

LJPLEX TELETYPE SOFTHARE 

Viz 4LL! RL5|HTYSHF,/C»JiS.>!PTySRF 

PTYSoh -SEUCO-TELEtvPE SERVICE ROUTINE FOH HALF OUPlEX 
ItLETYPE 50FTKARE 

Vl2 ALL! RL5IPTYSRH,/C»i:S,!>|PTYSRH 

SCHEUl ;.i;ME0ULlN5 au60RIThH for the TImE-ShaRINC iWAPPINB SYSTEM, 

CLKCSH SCHEDULINC ALGORITHII 

aC^S ,:OLU£ HA^DLI^C SUBROUTINES 

tsvAPPiNc Systems onl^3 

5Btl ^Li>!SCHE0l./C*3lSl Flaws, SI SCHEUl 

SCNSl!^ TELETYPE SEbwICE - FULL DUPLEX - 

bCANhLR INDEPLNUEMT (USES CCIINTi 
LCSI.vT, OR DLSINT) 

CEIThER SCNSRF of SCNSRH is ALt<ATS REOUIREOl 
t^tVER BOTH] 



(CONT'D) 
SCNSRH 



V14 
VI* 
SCCCON 



Vl4 

V14 

V14 

V14 
V14 
VI* 
Vl« 
V14 
Vt« 



MOMTR.OPR.a? 
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TtLETYPE SERVICE • HAI.F C'UPLEX- 

scanmeh IpMOepenhent <ysEs crjp.Tt 

nCSIfsT, 0« DLSIMT) 
tlTfttH SCNS^F OF SCNSMH IS 
AUalAYS REQUIRED] 
CNEVEH BOTH] 

CUSES teature Switches ftswap, 

FTLOGIN] 

42M RL«lSCNSRF(H),i'C*3ISiFT40N,«lSCNSBr(H) 

4?D> " FT40O 

sifSi " FTsas 

HUH USER SEG><ENT handling 

ROUT|N[S 

CAl,H»Y$ RE0U1RED3 

CUSES FEATURE SWITCHES FTSWap, 

FTOISK] 

^'''Nl RL6ISfcCC0N|/Cfi|S,FT4BN,6ISEGC0N 

*POl " FT4ao 

5'-St n FTSeS 

MONITOR IN1TIAUI2ATI0N 

[ALHATS REQUIRED] 

CUSES FEATURE SWITCHES FTSUAPi 

FT0ISK3 

""Nl RL6ISYSlNJ,/C*3lS,FT4aN,6ISYSlNI 

4S0I " FT4IIIU 

58SI " FT'JaS 



(CONT'D) 
SYSlliK 

TMPUUO 



n* 

UUOCON 



V12 
Vll 



HONITHiOW'M 
PA6t 097 



MAKES JOB «1 OVERLAY THE HONITOR 

Ktia BECOME THE NEW MONITOR 

ALtl RC6lSYSn4K,I.AS»/C*3ISi»ISvSN«K 

HANI)i.EII rOR IN CORE STORASt OF SHORT (OOLt flUt. 
CTHIS ROUTINE REQUIRES IF U9CR HANTS tO iPCCO 

UP ecu oPERAnoN AT THE cxnttsi Of AidvT ai 

WORDS/JOB In the NONITOR] 

tusEs Feature switch ttthrj 

4^NJ RL»lTHfUU0»/C«?i8»rT*fN»»lT«l»«B0 

4001 " rT««o 

uuo TRAP handler and device 

INOEPENOENT itVO ROUTINES 

UUOCON uuo TRtr MAMOWP AMD OIVlCE 

INDEPENDENT UUO ROUTINES 

lOCSS COHHON TO SUBffOUTTNES 

C ALWAYS REOUI"CO] 

[USES FEATURE SNITCHES FTSNAPi 

FTOISK} 

<|ENI RLtlUU0CONi/C*S|S.rT4tN«SIDUO0ON 

4201 " 'T«|8 

sesi " fTtit 



M0NIT«,0PR»«)Z 
P»GE 258 

VI* 3.1,9,2 DISK KEUaTEo koJTInES [LEVEL Oi 

Vl* cOmMOO disk OaTA BasLi CA^j include the OISk OATa 8ASE DUMP 

VI* WOUTINE DATn^H 

*J^ t-ITHOUT OAfoMpJRLl*iC0M»'0ti,F!Hi./C»3IS,CCNFIGil*lC0HM00 

lil C«ITH OATOMPJ RUl*'COM><OD.FIR,/c*3IS,CPMFlGiTTYI,14|C0MH0O,D*TDMP 

"*7 F TEXTEWf\as-j 

Vl* *i 

VI* tl 

VI* ONCMOD DISK PART OF ONCE 0>tLY 

^1* Rl.l*IO*<CMOD,L*5,/C*3lS,14IONCH00 

vt* refstr disk REFREShEK 

"*■* *«LX*«REFSTR,L*S,/C*3lS,i4|HEFSTR 

VI* SkPSER SilAPPlNC SERVICE 

Vi^ ''l.l*tSWPSER./C»'3fS»l*ISWPSER 

VI* FILSER DEVICE INOEPENDEMT FILE SYSTEM FOR DISK 

*1* RLlSfMUSER./C'SISitSIFILSER 

VI* OPXKON DISK PACK COmTROLLEH ROUTINE 

VI* [ASSEMBLE ONL^ IT YOU HAVE RPBl OR RPBZJ 

"** "LlSIOPXKON./C-JISilSiKONPAR.UPXKON 

Vi* FHXKON FIXED HEAD/DRUM CONTROLLER ROUTINE 

VlJ CASSEflBLE ONLT IF YOU HAVE HDIK OR HMIBB] 

*^* Rlil5IFHXK0N,/C*3ISil5|K0KPAR,fHXK0N 

Vt* mOXKON BRYANT OJSK CONTROLLER ROUTINE 

Vj* [ASSEMBLE ONLY IF YOU HAVE RBXeA3 

*'*• "LlSIMOXKON./C'SISilSIKONPAR.MDXKON 



MONITK,OPR>0Z 
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3,2 A<1 A '.'ITCH LIH«A«Y FILt l«lTrt PJP 



3.?,1 QHCtaiM; CONSTRAINTS FOR MONITOR UlSHARr FILE AND FOR 

lcajjng 

TWt ORljERING CONSTRAtMTS ON THE MONITOR IISRaRY FILE ARE 

\ll>-f FEW, 

3.?. 1.1 COKJiON MUST BE LOADED FIRST SINCE IT HAS EXTERNAL STATE" 
HE^TS TO LOAD THE OESIREO ROUTINES FRQM THE REST OF THE 
FJUt, IT AI.SO MAS THL 1*0 STARTING LOCATIONS IN IT SO 
IT 1UST BE LOADED FIRST, IT SHOULD NqT BE PART OF THE 
tlhHARY FILE (ALTHOUGH IT WILL 00 NO HARM IF JT IS,) 
V14 COMMOU SHOULD Ht PLACED AFTER COMMON IF IT IS N|EOED, 

3.?. 1.2 ALL THE REtUlREU A,\)D OPTIONAL ROUTINES MAY BE LOADED IN 
A'.Y CRDLR, 

3,?, 1.3 THl LIBRARY MUST END IN THE FOLLOWING OROERI 

i'i.l.J.i PATCH MUST HE THE FIRST OF THE L*ST ROUTINES, BECAUSE 
IT CONTAINS The FIRST UNUSED INSTRUCTION IN MONITOR, 

3.2.1,3.2 HOvIL MUST 8E NtXT 

3,?, 1,3. 3 SY5-riAK MUST BE NEXT 

3.2.1.3.4 EDLT, U LOAUEDi MUST Bt \EXT 

3.2.1.3.5 ONCE A--.J REFRESHER MUST FOLLOW EDoT So THAT IT HILL NOT 
TAKE UP ANY ROOM wHEN EDOT IS OESIRED TO BE AVAILABLE 
FOR EXEU MODE DEBUGGING (ONCE ONLY DIALOG QUESTION), 

Vl4 THIS REQUIRES ONCMOO 

n* REFSTR 

Vlt ONCE IN THAT OHdER, 

Vl6 IF 0\CE IS .vOt LaSTi THE MQNlTOH UriLL PROBABLY MALT 

Vl!> aFTLR UfcSTRQYING THE PROGRAM LOAOEO AFTER ONCE. 

3.2.1,!b KNOWING WHAT THE ORDERING COIJSTRAJNTS ARE YOU WlLL HAVE 
A^ OPPOHTLMTY TO DISCOVER SHORT CUTS TO THE ABOVE PRO" 
CEDJRES, FOR EXAMPUEi IT IS POSSIBLE TO KEEP YOUR OLD 
LIBRARY FILE AND LOAD A FEW AD01TiO»JAl AND/OR REPLACEMENT 
RCuTI»<i.S FIRST, SINCE THE GLOBAL REQUESTS HILL BE SATIS" 
FItU The loader WILL NOT LOAU THE OLDER LIBRARY ROUTINE, 
CF COURSE SINCE COMMON MUST BE THE VERY FIRST LOADED ROU» 
TI^E, IT MUST PRECEDE ANY OF YOUR ADDITIONAL ANO/OR 
REPLACEMENT ROUTINES, 



Mai«lTH,CPK->;2 

PAGE t'6^ 

i.'i,2 '.'U- THAT YOj -AVE Ct^EATtU ALL uT fHt 'iELOCAT ABUt- BINARY 

fiLLi ^ITH THt ASSL'-iJLLH, VOU iMUjL:^ C"'MHII.E TntK INTO A 

^~ ITD-) Llc^ARY FtLt 3N«».WEL rOf< 1;V4. SYSTEM A^0 
iS»|-',;<LL FOK i 13/b,i iYjTE^, 

.i,2,7 Ai;-J M\G THAT THE ^-I^Ar^IES A'^f. STU.L V LOGICAL DEVICES 
^'l" "L''' ■*L». ><!.a,;,L14 1/) HUtJ, IF tOGIcAL UFVICtS RL*f RL&» 

Vl* nLf-'^'Ll* AUl. -Lis A«r THE j,Af<E OE>iICt, aAY 3SK AMD IF 

vl" mAkI-G a 1,"/4, LIBi^A-JY FlLt, TYPE: 

FOR IB/5. sYSTE-^S: (ALL f^ELs 0% DISK}; 

,H PIP 

VI* •DSi\:LAST/B*USK!PATCH.LA5,r10VI£,LAS,SYSMAK,|,AS,tODT,LAS,Q'.i;t,LAS 

Vl* •Obr<(>N»«,REL/B'-OSKH>,RtUiuSKiL*ST 

VI* IF LOGICAL 0EV1LE5 ^LI.HLS, HL6|Hl1* A^U HLliJ AHt THE SAME 

VI* DEVICE Say asK an.j if haki^g a u/^a library file type: 

FOS 10/>.; SYSTEMSi (ALL WELb Q^i USK)« 

,R PIP 

Vl^ •fSMUAST/b»DSKlPATCt,.LAS,?i0VlE,UAS,SY';MAK.UAS,fcCDT,LAS,0NCM00.LAS.WEFSTR,L*5,CNCE.LAS 

VI* •DS!<ISS»#,REL/8*DSK;»,RtL,i;SKIL*S>T 

V16 •DSi<l»,REL/R»«.H'« 

Vt* IF LOGICAL DEVICES r<L*< ^Lbi RL61RLI* ANO RL15 *RE DIFFERENT 

Vl* DEVICES! AND IF MAKING A ll^/4i; LlgPARY MLEi TYP£I 



VI* 
VI* 



FOR 10/«i' SYSTE^^S (RELS n\ DECTAPEJI 

.R PIP 

• RL*ILAST/B*RL5!PATCrt,LAS,r-l0VIE.UAS,RL6ISYSMAK.U*S,RL5lED0T.LAS,0NCE.LAS 

• RL*l5S»#,RtL/B-RL*f.HtU,RL5l»,MEl.iRL6l*.REU.HUl*l»,REU|RtlS«».REUiRL*IL 



AST 



Vl* IF LOGICAL DEVICES RL*. RL&i Rt6i RLl* AND RL16 ARE DIFFERENT, 

AND IF Making a la/sv library fiue' typei 

FOR IB/SC systems (RelS ON DECTAPEJt 
,R PIP 

Vl^ •Rt5ll-*ST/B»RLt>iPATCH.LAS,M0VIE,UAS,HL6ISYS»',AK,LAS,RLSlEDDT.LAS.HL14|0NCM0O,LAS,REfSTR,LAS,'^L15l0NCE,LAS 

Vl^ •''L*l5S##.REL/e-RL*l«.HEL.SL5i»,REL.RL6t».PELiRl.l*l»,REU,RLl5l»,REL7RL*IUAST 

WHERE THE /B SAYS COPY BINARY (HhlCH THIS IS) AND THE 
•.PEL SAYS COPY ALL REL FILES, FILES PATCH, UASi MQVIE.UAS 
SYSMAK.LAS.EDDT.LASiONCMOO.UAS.RtFSTH.LAS ANO ONCE, LAS MUST 

BE LAST AND jM That order, ALL Of the other files may 

BE JN ANY order. however THEY HAVE BEEN ARRANGED ALPHA- 
BETICALLY, 



PACE 061 
3, J lOa:1 'IDMITBK USIImG LOADER 

TO LUAD T'i- -0MT38 FOULOU SLCTIONS Z.J.l. THROUGH 2,4,4, 
3,4 SAVE -iCflTO" JSIN.5 -lUNITOW SAVt COMMAND 

SAi,t. JTAl XXX'-QN 

,.Wh-ife HXXMO'; IS THE ^AME OF YOOR wDNlTaR, 
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4, PATCHING IfUUK MOMTDx WITh ijljl 
4.!' PATCwInu COf.POi^F'.TS 

4. J, PATCHl.NC. *ITH US£.« OCT :;...iLH IIUbShAHING 
<«,Z PATCHING WITH ExtC DDT ST A.AiC-AUO'NE 
4.3 PATCHING CONVENTIONS (tITHtR POT), 

4,B REQUIRED COMPONENTS 

4..:',i FOf* PATCHING wUH USE?! UUT UNUEH T I f^tSr^AH INC 

4,v.,l.X MONITOR ON DECTAPE ^HICH wAS L'^ADED UlTH 
USER DOT (/D ShJTCH TYPED TO LOADER,) 

VI* 4.i;il,2 UP TO 3Sk of user CORE AVAILABLE TO 

A SINGLE USER UNDER TIMEShARIMG 

*.'.:, I, i A RUNNING TIME SHARING MO'^ITOR 

4. a. 2 FOR PATCHING WITH EXEC OUT OUT Of TIME SHARING 

*,\i,Z,l MONITOR ON OECTAPE WHICH wAS LEADED WITH 
EXEC ODT (ANSWER Y TO MONqEN DIAIOC) 

4./|2,2 JUST ENOUGH PHYSICAL CORE TO LOAD 
MONITOR. THIS TAKES LESS CORE THAN 
PATCHING KITH USER DDT BUT MACHINE CANHiOT 
BE TImEShARED, 



PAOE l«3 



4.1 PATCHING "IJTH USER 001 UNDER T|ME SHARING, 



4.1. i USf.« DOT IS RECOMMENOEO FOR PATCHING OVER EXCC OpT 

Sl'^Ct MACHINE MAV BE TIME SHARED OURINS PaTCHINI! PROCESS, 
(MiTE A COPY OF THE MONITOR IS PAtCHEDi NOT THE ONE 
COr.TROl.LING THE MACHINE,) HOWEVER IT REQUIRES HORE 
CORE ON YOUR SYSTEM THAN DOES PATCHING HJTH EXEC DOT, 
Vl* THtt<t MUST BE AVAItABLE UP TO 38K Of USER CORE 

AVAILABLE TO A SINGLE .JOB UNDER TiHE SHARING IN ORDER 
TO MAKE THE PATCHES WITH USER DOT, IN ORDER TO HAVE 
LOaUEO USER ODT WITH YOUR MONITOR YOU MUST HAVE USED THE 

/o Switch, if you did noti you must reload your monitor, 

YOU do not need to CO THROUGH THE MOHGEN OIALOCUE AOAIN. 
HOkEVERt BE SURE TO ALSO SPECIFY THE /S SWITCH $0 THAT 
LOCAL SYMBOLS ARE LOAOEDi PATCHING W|TH-0UT LOCAL 
SY^'BOLS IS NOT RECOMMENDED, 

4.1.2 GET COPY OF YooK MONITOR BY TYPING' 

Vi« GET dTAN 6S45A 

TO THE HUNMNG time SHARING SYSTEM, WHEN THE MONITOR 
RESPONDS WITHI 

JQd StTUP 

■ 

TYPE! 
CUT 
WHICH ^JLL START UP USEK DUTi 



M0NlTR,0PR»a2 
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4.1.3 *FTtH ALL f-ATCHES *RE HADE, TYPE <C!3IJT«0L>Ci 
FOLLCHEU BYI 

Vl* SAVE UTAN 5S*SB 

BE CA«EFuL ^OT TO TYPt <COfvTROL>C T^lcE. LEAST YOU RETyRM 
TO MOMTOR MODE BEFORE DOT MIGHT MAKE US LAST 
MODIFICATION. (SWiPPI^G SYSTEMS OhL^l. 

4,X.4 YOU MAY SAVE THE PATCHED MONITOR ON THE DISK TOOi SINCE 
VI* THE FORMATS ARE THE SAME IN THE b SERIES MONITOR 

6E SURE TO wRiTt MONITOR ON OECTAPE USINS MONITOR SAVE 
COMMANO RATHER THAN COPYING IT WITH PiP, SINCE THJS 
SAVED FILE hUST BE LOADED WITH TEnOHP. ALL SAVED FILES 
KHICH KILL SEVER 8E LOADED BT TENoMP MAY BE COPIED BY 
PIP (USING /B SNITCH OF COURSE), 

4,2 PATCHING WITH EXEC DOT STAND-ALONE 

4.2.1 EXEC DDT |S RECOmMENOED ONLY IF YqU Do ►^OT HAVE ENOUGH 
CORE FOR PATCHING WITH USER DOT, IT IS ALSO RECOMMENDED 
THAT ALL PATCHES BE MADE WITH e|thER O^E OR THE OTHER 
BUT NOT BOTH, THIS IS BECAUSE THE SYMBOL TABLE POINTER 
BECOMES CONFUSED AND TENDMP WRITES BLOCKS CONSECUTIVELY 
WHICH CAUSES THE TAPE TO ROCK ON A MONITOR GET FQR EACH 
BLOCK, HOWEVER! SWITCHING CAN BE DONE IF THESE RESTRICTIONS 
ARE OBSCRVED. 

4.2.2 IF THE MONITOR TO BE PATCHED WAS PREVIOUSLY PATCHED BY 
EXEC DOT. THEN PATCHED BY USER DDtt ONE SPECIAl'aCtION 
MUST BE TAKEN BEFORE EXEC DUT WILL BE ABLE TO REFERENCE 
THE MONITOR SymBol TaBlII THE CONTENTS OF ABSOLUTE 
LOCATION H6(J0BSYM) MUST BE PLACED IN ABSOLUTE LOCATION 
JKOOTSYMXTHE PLACE WHERE DDT EXPECTS TO FIND ITS SYMBOL 
TABtE POINTER). THIS IS CONVENIENTLY ACCOMPLISHED WITH 
THE FOLLOWING COMMAND TO EXEC DDT. 

MOVE 116SX 
MOVEM 36$X 

NOTtI THE FIRST TiMt CONTROL WENT TO 141, 0(1,16) IS 
COPIED TO 36» THEN THE COPY CODE IS OVER WRITTEN, 
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4.2.3 LOAO THE MONITOR FROM OECTaPE WJTh TENDMP, WITHOUT 
STAHTINC BV TYPINGI 

Vlt UI5S4?* SAV 

FOLLOWED Br CARRIAGE RETURN TO TEnOmP. 

THL.M SPECIFY EXtC ODT STARTING ADDRESS AND START 

IT ilP BY TYPlNiGl 

141J 
GS 

1.2.4 kHtN YOU ARE FINISHED PATCHJNCi TyPEI 

774(;0»6 

TO RETURN TO 32K TEMOMP (374190 |F 16K, 137410 IF 4SK| 
ETO, 

4.2.5 SAVE (DUMP) THE MONITOR ON OECTAPE 8t TYP|NOI 

Vl4 Dl&S4»S SAV 

FOLUOt'EU BY CARRIAGE RETURN TO TEnDMP, 
HARMING . DO MOT TYPE A PERIOD BETWEEN NAME AND CKTCN- 
SICN, BECAUSE T|NOMP WJU HAKE IT BE A PART OF NAHEi AND 
MONITOR AND CUSPS Witt NOT BE ABUE TO OET FUE, 



MAGE. 066 



i.i pATCtilNG CORRECTIONS (EITHEH UUT) 



THt F0LLC'»'IN& TECMt^iaUES Fni< MOMTOfi PATC^rif. ARE PAHT CONVE:MTIOrv 
tf.O >^ART -'ECESSITV! IT IS i«ELU To FqLLC. THC" CaKEFULUV, 

1.3.1 tXLC OUT BEHAVES ALf^OST EXACTLY HKE USER DOT AS 
DESCRIBED I'J THt DtiT kaNUau (iltC-li^ " 




4. J. 2 ALt»*YS PATCH A FRESHLY LOAOEB COPY OF THE MONJTOfi-ONE 

UiHICH HAS NOT YET RJN THROUOH THt IMTULUATION DIA|,OCUE, 

4.3.3 LOAOEO into EACH MONITOR IS A BUOCK OF PATCWING 

SPACE BtCINNiNG AT ULObAL LOCATJOm PATCH, BY CONVENTION, 
THE VALUE OF THIS SYMBOL IS NOT CHANGED WHEN PATCHES ARE 
MACEl INSTEAD, ANOTHER SYMBOU. PAT, IS HEDEFINEO BY THE 
USEH AFTER EACH PATCH SO AS TO POINT AT ALL TIMES TO THE 
NEXT FRtE LOCATION In THE PATCHING AHEA, THUS, 'THE VERY 
FIRST PATCH IK ANY SYSTEM wJLL BtGlN AT SYMBOLIC LOCATION 
PATCHI ALU SUBSEQUENT PATCHES ^Hl BE MADE STARTING AT 
SYMBOLIC LOCATION PAT. BUT THIS SYMBOL WILL BE CHANCED 
TO POINT TO THE NEXT FREE LOCATIQm AS THE LAST STEP IN 
MAKJNG ANY GIVEN PATCH, 6Y THIS MEANS. THE NEXT PERSON 
TO PATCH THE MONITOK WILL BE ABLE TO FIND THE PATCHING 
SPACE, 



4.3.4 SUGGESTED PATCHES ARE UlSTRIBUTEU IN A NOTATION CONSISTENT 
WITH THS ABOVE MECHANISM, EVERYTHING THE USER HUST TYPE 
TO EXEC DOT IS INCLUDED JN THE SUGGESTED PATCH INCLUDING 
THE OOT COHMANO WHICH UNLOCKS THE PROPER SET OF LOCAL 
SYMBOLS. 

4.3.5 THE TlMt SHARING MONITORS BEGIN To ALLOCATE FREE CORE FOR 
VARIOUS INTERNAL FUNCTIONS JUST AbOVE THE LAST PATCH 
LOCATION IN USE. FOR TH|S REASQM IT IS VERY IMPORTANT 
THAT, AS A LAST STEP IN ANY PATCHJNG SESSIONi THE USER 
INFORM THE MONITOR OF HOW MUCH ADDITIONAL PATCH SPACE WAS 
USEO, OTHERWISE, THIS SPACE HILL BE ALLOCATED AND THE 
PATCHES WILL BE DESTROYED, THE USER SHOULD HAVE REDEFINED 
LOCATION PAT AS THE FIRST FREE LOC*TION| TH|S HAVING 

BEEN DONE, IT IS ONLY NECESSARY To OPEN LOCATION PATSI2 
(LOCATION 0NCE*1 IN OLDER MONITORS) *ND RETYPE ITS CONTENTS 
AS 

MOVEI TAC.PAT 
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(4,3 CCMT <0) 

<,3.6 IT lb COf.SIiJE»Et) GOOD PRACTICE TO CHANGt THE NAME OF A 

Vl^ LVL-<Y TiHE IT IS PATCHLO, FOR EXAMP1.E. &.18A vICHT 

Vl* !Ei:J'>L S.iea J.<EM PATCHED FOR THE SECO»lD TIME, IF ALU 

JM'LICIBUE DEC-HELEA3E0 PATCHES ThROUGH LEVEL X HAVE 
i-Ft 1 APPUltJi THEN IT IS OJR CONVENTIO'i TO NAME THE FIELD 

vl" IMiJf. >^'0(.IT2R 5,18X, THE NEW NAME ShOJLD BE ENTERED AS 

7 -IT ASCII TEXT IN LOCATION CONfiC lA>lD THE SEVERAL 
intATIONS l^wICH FOLLOW - UP TO Z« CHARACTERS), 

■OTL! IF THE maME is a MULTIPLE OF 5 CHARACTERS LONCi 
MAi't SUHE THL VtXT HOHO CO'>iTAINS A 2ER0 TO DELIMJT THE 
TEAT bTRING, LIKEWISE, THE SYSTEM UATt IN LOCATION 
f.YS3AT AND SYSDAT*! SHOULD 8E UPDaTEO (IN 7 BIT ASCII TEXT), 

4,3.7 nEvLH save a monitor WHICH HAS ALREADY BEEN RUNi AS JT 

i>ILU BE USELESS FOR RELOADING, If THE SYSTEM IS ACCtOENTLV 
ftUt BEFORE SAVED, START AGAIN WITm A FRESH COPY AND 
hti AKE The PATCHES, 

4.3.,-> p«hT«JcT10S3 A^^U A^' EXAMPLE FOR PaTCHINC THE MONJTOR| 
THI. TIlE TO MAKE PATCHES IS AFTER THE MONITOR HAS 
f-ELv unAaEO Bl'T before it HAS BEEN RUW, IN ORDER TO PATCH, 
IT lb --tCESSARY TO HAVE A COPY OF EXEC MODE DOT LOADED 
».IT« THE MO'^ITOR, IF YOUR SAVED VERSION OF THE 
MOMTijK DOES SOT CONTAIN DDT, YOU MUST REPEAT THE MONGEN 
DIaLOU and RELOAD YOUR MONITOR AND ANSWER YES TO THE 
GUtSTIUNS 

LOAO fcXEC DOT? 
AND 

LUCAL SYSaOLS? 

sli-ce «oth are necessary for patching the monitor, jt is 
fossihlE to Patch without local Symsous, but it is not 
wet;0;;mlnded. ;)isthhuted patched will assume local symbols, 
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jn.K PATCHES Themselves ake given i^ t^^e kokmat of dot 

TEUt-TYPt OIAUOSUE, THE LOCATIONS A^t =LMAHEO BY THEIR 
SrtiiiDL MAMES, IF A USER JOES isQT HAVE LOCAL SVMf,OlS LOAOEDi 
ME S>,QUUO REFFR TO HIS mOMTOR SToRaGE f-AP A.^0 LISTING 

Tc tkanslate local Symbols to GLObAL symbols amj literals, 

TMt; KIRST command in each GHOgP IS THE C0MMAN3 TO UNLOCK 
THE LOCAL SYMBOL TA8LE I^ THE N*^'£D ROUTINE, 

-.OTEi i IN, THIS SECTION STAinDS FOR THE ALTMODE <tY 

EX! USER Types corsrsji tty output t*b and 

DOT MOW f-AY REFERENCE 
THE SYMBOL TAdLE OF THE 
ROUTINE CDR3R6, 

AT THE E^0 OF THE MONITOR IS A S^'ACE OF AeOUT iejUS) 
LOCATIONS taHlCH IS RESERVED FOR MONITOR PATCHEsi THIS 
PATCH BUFFER BECImS aT SLOSAL LOCATIONS PATCH, TO INSERT 
A PATCH IvITHlV A MONITOR ROUTINE, THE PROCESS IS TO BEGIN 
ANC THEN TO WRITE TwE PATCH BECINvING AT LOCATION PATCH, 
THE LAST INSTRUCTION IN The PATCH SHOULD BE A jRST SACK 
TO TmE monitor, 

EXi 1\ THE ROUTINE BAH YOU WOULD LIKE TO CHANCE FROM 
BAH21 JFCL BAH2I JFCL 

HRRS mm TO ADOI l^fK 

FMpR 1,1 HRRS 2,0 

FMPR 1,1 

IN UDT YOU WOJLB GIVE THE COMMANO 

BAHSI «IHICH UNLOCKS THE LOCAL SYMBOUS IN BAH 

THE'* TYPE 

BAH2*!/ .JHICH OPENS ANO TyPES OUT THE CONTENTS 

OF BAH2*1 

THE TTY THEN OUTPUTS 
(TAB) HRRS 01? (TAB) 
YOU KIOJLO THEN TYPE IN 

JRST PaTCH(TAB) the TAB CLOSES THE LOCATION BAhZ*! 

WHICH IS NOW MOoIflED ANO OPENS LOCATION 
PATCH 



M0NITR|0PR-92 
PAGE 069 



(4, J, 8 CCM'D) 



TTV RESf>ONSt IS 
PATCH/ lTAB)k)(T*B) 
VOL THEN INSERT 

LINE FEED CUOStS THg UOCATION 
AND OPENS THE MEXT ONE 

TTy UUTPUTS 

patc;h*i/(tab),i(T*b) 

you insert 

HRt^S ^.kjttlNE FtEO) 

TTY OUTPUTS 
PATCH*2/(TAB)0(TAB) 

YOb INSERT 

JRST bAH2*2(UINE FEED) 

TTY OUTPUTS' 
PATCH»3/«TAB)(?(TA8) 

YOi' Insert 

PATI (CARRIAGE RETURN) 

<THIS RENAHES ThE CURRENT LOCATION WITH 
GLOBAU SYMBOL PaT 

THE ENTIRE DIALOGUE WOULD LOOK \,Ut THE rOLLOMINCI 

BAH^I BAH2«X/ HRRS »i» JRST PATCH 

PATCH/ a ADOI 010 

PATCH*!/ 1? HRRS BiB 

PATCH*2/ 'c JHST BAH2*2 

PATCH*3/ U PATI 

THIS LAST STEP IS QUITE IMPORTANT, THE GLOBAL PATCH 
ALWAYS POINTS TO THE BEGINNING OF THE PATCH AREA, ONLT 
THE FIRST PATCH IN THIS AREA WILL BEGIN AT LOCATION 
PATCH, AFTER EACH PATCH IS MAOEi THE FIRST UNUSCO LOCATION 
SHOULO BE RENAMED PAT, THIS IS NECESSARY TO DETERMINE 
>.HE:RE SUCCESSIVE PATCHES SHOULD BEGIN, 



MONITR,OPR'»ez 
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(4,3.8 C0^iT'Q> 

fcHEs THt PATCHING SiSSION IS COlPutTE, THE GUOP*L LOCATlO'-i 
PATSU SHOULD TME^ BE OPLNLO AND SHQUUH BE Al,TE«LD THUS 

^ATSIi/ MOVEI XiY iiOVEI TaC.PaT 

THIS INFORMS THt MO^ilTOH WHERE Tl-^F CURRENT END OF THE 
PATCHES IS, A COMMON ERKOR TO FUBCET THIS STEPi WHICH 
*\V\. CAUSE THE MONITOP TO UOOP WHEN STaHT£d UP INSTEAD 
OF HUNNJNG THE NULL J0B| THIS IS BECAUSE THE mOMTOH 
i.JLU HAVE CREATtD COPIES OF MJtTlPUE OEVlCE DATA BLOCKS 

o^ TOP OF Youn Patch, in ADOiTro\, the global locations 

CO'.FIG AND SYSOAT SHOULD BE UPDATED To IDENTIFY THE NtH 
MONITOR VERSION AND DATE OF UPDATE. 

Vl* EXI C0NFI6$;T/ 5Z7Q "/aZ7t/ 

«7T IS A COMMAND TO PHJmT ThE CONTENTS OF THE 
PRECEDING ADDRESS AS A 7 9lT ASCII CHARACTER, 



" MEANS INSERT THE ASCJl TEXT FOLLOWING THE I 
IN THE CURRENT OPENED LOCATIONS TERMINATING THE 
TEXT WITH THE SECOND /, 



Vl< ALSO SYSnAT$7T/ Bl-?1 ••/04-ai/ 

Vt« SYSDAT*1»7T/ -64 "t-TK/ 

THIS ALSO COMPLETES THE PATCHING PROCESS, AT THIS POINT 
THE MONITOR IS READY TO RUN, IT SHOULD NOT BE STAHTEDi 
HOkitVERi UNTIL * COPY WITH THE PATCHES JS SAVED ON A DECTAPE 
FOR FUTURE RELOADING, 

AS AN AlO TO PATCHlNGi IN THE DISTRIBUTED PATCH RELEASES, 
USER INPUTS TO THE TTY AHE IN LO^-EH CaSEI DOT OUTPUT IS 
IN UPPER CASE, 
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6. CRASH PRCCtDUNES IN MONITOR »»iei. 

Via THERE IS A NEW, EASIER CRASH PROCEDURE IN MONITOR 55,«i, IT |l 

VIB DCCUMEKiTtU I^ MONCSP,«AN 8UT MANY PCOPtE HAVE NOT SEEN ITi |T 

Vl" IS IMPERATIVE THAT CRASHES BE TAKEN CORRECTuV* ESPECIAUV NOH 

Via ThAT CRASHES ARE OCCURRING SO !Nf REOU£^TlY, THC NEW PMCCOURC 

V10 SAVES THt HAROHARE STATE OF THE MACHjNt, INCLUOINC PC» ALL 10 

VlB DEVICE STATUS AND AC'S, 

V16 A. riUL PUT A SOFTWARE ERROR REPORT FOHhCSERJ, SEE ERROR, f«M 

V16 niSTRliJUTEO AS A SOURCE F1I.E, 

V16 1. FUD FIRST EMPTY FORH IN SOFTWARE LOGBOOK ANO 

Vi6 FILU OUT NEKT HIGHEST SER flUMBER WH£RE JT SAVS "CRROR NOt" 

Vi6 2, FILL OUT MONITOR VERS10»(i PATCH LEVU, 0ATE» Tl»ti ANO HHO, 

Vl6 3. WRITE DOWN PC, Ma. InSTR, REG,, AniO P] {N PROCRCfS 

T16 IN 8ALNKS PROVIDED, 

V16 4, CHtCK BOX FOR REASON FOR CRASH, |E MAcT, NXM, LOOP, HUNG, 

Vl6 CUSP, OTHER 

Vie e. FIND CURRENT USER JOB NUMBER IF NOT |ERO, 

Vl» 1. IF SWITCHES ARE NOT SET TO Iff (LOCATION JOB) 

Via SET THEM TO 150 ANO PUSH EXAMINE, 

Vl» 2. COi'.VERT OCTAL LIGHTS TO BECIMAL 

Via 3, SHOUT h'HO IS Joe «N}, WHERE N IS THE DECIMAL NUM|ER| 

Via (IF OO NOT BOTHER, NULL JOB WAS RUNNING) 

Vl" 4. GO TO THAT USERIS TELETYPE ANO COH-ECT HIS OUTPUT, 00 

Via THIS QUICKLY AS USERIS TEND TO CLEAN UP WHEN SViTCH 

Via CRASHES, THEREBY DESTROYING USEFUL INFORMATION,' 

Via c. SET MONITOR TO TAKE AUTOMATIC DUMP 

Via 1, SET AODKESS SWITCHES TO SB 

Via 2. PUSH EXAMINE THIS TO HAKE SURE iU HAS B, 

Via 3. CHECK MEMORY ADDRESS LIGHTS TO MAkE SuRE 3B APPEARS THERE, 

Via (maYBE not if INTERMITTENT CONTACT OF CONSOLE »«|TCHES) 

Via 4, SET ONE OR MORE DATA SWITCHES TO N0N«iERO, 

Via 5. PUSH DEPOSIT "THJS", 

Vl6 6. PUSH "CONT"i MONITOR SHOuLO HALT WITH PC»ia, 
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6,1 SAVE CRASHED MoNIToH ON UJSK WITH BOOTS 

V16 THERE ARE HAnY ADVANTAGES TO SAVIMG CRASHED "ONIaTRS ON DISK RATHEH 

V16 THAN OECTAHE, 

Vl6 A, FASTEH 

VJ* B, SAVE aUU JOB OaTA AREAS IF MACHINE HAS MO«E THAN 

V16 6^K OF COHE 

V16 THE ONLY OJSaDVANTAGE IS THAT THE SPACE FOR CRASH, SAV MUST BE 

Vi6 PREALLOCATEQ, THE ONCE ONUY OlAUOS ASKS THE NUMBER OF K TO 

V16 BE ALLOCATED TO CRASH. SAV ON EACH FILE STRUCTURE, IF'VOU HAVE 

V16 A Small CISKt YOU will probably choose TO USE TENDMP TO SAVE 

V16 CRASH AND RELOAD HONITOR (SEE 6,2 BELOW), 

V16 D. LOAD PAPER TAPE BOOTS ASSEMBLED FOR BICCEST SIZE OF MEMORY 
Vl» (NO LIMIT) SO THAT ALL OF MEMORY WILL BE DUMPED, 

V16 i, SET HEAO IN DEVICE SWITCHES TO 1194 (BITS S AND V DOWN) 

V16 2. PUT BOOTS IN P*PeR TAPE READER 

V16 3. PUSH STOP, RESET REAQIN (PAPER TApE HJLL READ-IN) 

Vl6 E. DUMP CORE On DISK 

Vl* 1. TYPtI DSKBI/O 

Vl* rOLUOWEO BY CARRIAGE RETURN, WHERE 0SK8I CONTAINS A 

VJ» CRASH, SAV ON Cl,4] WHICH IS BIG EnOUSH TO HOLD »LL OF CORE, 

VJI IF BOOTS RESPONOS WJTH A CLICK IMMEDIATELY, IT MAY BE THAT 

VI* CRASH, SAV HAS MJSTaKeNLY ASSIGNED K WHEN FILE STRUCTURE 

Vi* MAS DEFINED, OR FILE STRUCTURE HAS SPECIFIED WHICH 

Vt6 HAS A CRASH, SAV WITH eK, 

Vi6 r. RELOAD MONITOR - 00 NOT RESTART 

VI* 1. TYP| JUST CARRIAGE RETURN TO BOOTS. BOOTS WILL UOAD SYSTEM, SAV 
Vi* PRON SYS, 
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(6, CONT'D) 

6.2 SAVE CRASHtO MONITOR ON DECTAPE WITH TfcNDMP 

Via D. LOAD PAPER TAPE TENQMP ASSEMBtEO fOR BI6CEST SIZE OF MEMORY 

V10 ( JP TO 64K IF VOU HAVE 64K OF MEMORY) SO BUMP klL Of COREi 

Vl0 1. SET REAP IN DEVICE SWITCHES TO 1?« (BITS 9 *N0 » DOWN), 

Vie S. PUT TEnOmP in PAPER TAPE READER 

Vie 3. PUSH STOP, RESET, REaOIN JPAPER TaPE HlLt RCAOINJ, 

Vl" E. DUMP CORE ON DECTAPE 

Via 1. MOuiMT DtCTAPE ON ANY CONVENIENT UNlTi SAY N( 

Vl0 2. SET WRITE ENABLED, 

Via 3. TVPE NJ (WHERE » » ALT-MODE) • TAPE N HILL SPIN, 

Via ^. TYPE i% {WHICH ZERO'S TAPE), 

VlB 5. TYPE OSCRASH SaV FOULOHEO BY CARRIAGE RETURN, TENOMP 

Vl0 wIUL WRITE ALL OF COsE ONTO OECTApE, 

VlB F. UABEL TAPE 

V10 1. REMOVE TAPE FROM REEi. AND MARK REEL ' ON CRASH FQRMi 

Via 2. PUT LABEL ON TAPE CONTAINING MONITOR NAME, DATE» AND 

Via CRASH SAV, 

V16 3. PUT TAPE IN CRASH RACK, 

V16 6.3 COPY CRASH FROM OECTAPE TO DISK AND EXPAND, 

Via 1. LOGIN UNDER 1,2 

VlB 2, MOUNT MONITOR CRASH PROCRAMS ON DECTAPE, IF fiLlXi 

Vl4 FILOOT.TXT, FO5S01,SaV ARE NOT ON CUSP, AND ASS16N OECTAPE 

VlB (SAY DTAN), (SEE MONCSP.HAN IF YqU HAVE NOT MADE A 

V14 F05Sii)l,SAV FOR TQUR SYSTEM), 

Via 3. ASSiSN OECTAPE (SAY DTAXJ CONTAINING CRASH, SaV 

Via 4. TVf^E R FILEX OR RUN DTAN FREX, 

Vl6 •sysiser*«*,xpn/e/q>otaxicRash,sav 

V16 ImERE ##» IS THE SOFTWARE ERROR NUMflER OF TH|5 CRASH, 
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V16 6.4 IF CHASH WAS DUMPED ON QJSK WITH BOOTS ON SYS ICRaSH, SAV 
Vl6 EXPAnU USHG MLEXI 

VI' •SVS!SfcR««#,XPN<055>/E*OSK8!C«AsW,SAVCl,4J 

V16 

<'!* '•'<tRE #*# IS The Software ewhor number of this crash, 

via I. PRODUCE FIUDDT SymBOUIC OUTPuT OF CRaSH 

V16 1. TYPEI 

VI* ASSI5N OTAN Sys IF FpSSai NOT ON CUSP. 

VI* 2. TYPE assign DSK UPT (SO THAT FO5S01 U\\,\, WRITE FILE 

viB snap.lst on DSKJ, 

VI* 3. TYPE R FD5S2t. 

VlJ *. FD5SB1 wat COMPUTE FOR X* TO 18 MINUTES, SEE WHEN DONE. 

VI* YOU MAY TYPE ONE <CONTROi;>C AHEAD WhJuE IT IS COMPUTING 

VI* AND TYPE AHEAD ANOTHER COMMAND OR TWO, SUCH ASl 

Vi* .LIST SNAP.LST 

VI? 6, PUT LINE PRINTER LISTING UNOER WHITE 30X, 



Vl6 END OF "MONITR.OPR" 



8. SYSTAT MONITOR COMMAND 

8.1 THE MONITOR COMMAND SYSTAT CAUSES A CUSP TO BE RUN WHICH 

PRINTS STATUS INFORMATION ABOUT THE SYSTEM, IT MAY EVEN BE 
TYPED WHEN THE USER IS NOT LOGGEO'IN, THUS ALLOWING THE USER 
TO DETERMINE THE LOAD ON THE SYSTEM BEFORE LOGGING-IN, SOME 
INSTALLATIONS MAY CONSIDER THE SYSTAT INFORMATION PROPRIETARY. 
IN WHICH CASE THEY SHOULD CHANGE THE PROTECTION OF THE SAVE FILE 
(SYSTAT, SAV) ACCORDINGLY. SO THAT ONLY OPERATIONS PEOPLE MAY 
USE IT, 

TO DIVERT THE SYSTAT OUTPUT TO THE LINE PRINTER, ASSIGN THE LPT 
AND GIVE IT LOGICAL NAME SYSTAT, TO WRITE THE OUTPUT ON THE DISK AS 
A FILE WITH NAME SYSTAT.TXT, ASSIGN DEVICE DSK AND GIVE IT 
LOGICAL NAME SYSTAT, 

THE BEST WAY TO DESCRIBE THE SYSTAT OUTPUT IS WITH AN EXAMPLE: 
Status o1 5S, 0(116 LEVEL D at 11159111 en 08-May'70 



Uotlma 01119107, 7% Nul 
Job Who Whara 



I time ' Idla^Lost > IX 4' 6X 
What Size Stata Runttma 



1 


10.6|2 


TTY2 


SYSTAT 


2K 


RN 




00100101 


2 # 


20,574 


TTY6 


PIP 


IK 


TI 




00t02tia 


3 


• •■•• 


TTY15 


SYSTAT 


0K 


»C 




00100100 


4 


• •(•• 


DET 


F4a 


IK 


tC 


SW 


00l00t01 


5 


• •(•• 


DET 


LOGOUT 


IK 


tC 


SW 


00I03S42 


6 


20,574 


TTY12 


SYSTAT 


2K 


tC 


SW 


00100:01 


7 


11.554 


TTY4 


F4021B 


9K 


TI 


SWF 


00ll3t43 


8 


• •,•• 


DET 


PRINTR 


4K 


RN 




00100111 


9 


1.2 


TTY13 


OMOUNT 


5K 


SL 


SWF 


00i00i03 


10 


2.172 


TTYl 


FOS0i6 


18K 


RN 




00135151 


11 


30,110 


CTY 


PIP 


IK 


TI 


SW 


00100105 


12 


2.171 


TTY3 


SYSTAT 


2K 


»C 


SW 


00l00t01 


13 


11.131 


TTY5 


TECO 


2K 


RN 




00100106 


14 


#*.•• 


TTY0 


LOGOUT 


IK 


TI 




30100101 



High Sagmantsl 
Program bavToa 



Owntr High K U3ars 



(PRIV) 

LOGOUT DSK 

PIP 

TECO 

F40 

PIP 



bSK 
bSK 
6SK 
DSK 



Job 5 

SYS 

SYS 

SYS 

SYS 

20.574 



2K SW 
2K 

3K SW 
2K 

9K SW 
3K 



Dormant sagmantsi 
Program bavTea Ownar 



High K 



COMPIL 


DSK 


SYS 


3K SW 


MACRO 


bSK 


20.574 


5K SW 


MACRO 


DSK 


SYS 


5K SW 


CREF 


bSK 


SYS 


IK SW 


LOGIN 


DSK 


SYS 


IK SW 


RUNOFF 


DSK 


20,574 


2K SW 


COMPIL 


bSK 


20,574 


3K SW 


TECO 


DSK 


20,574 


2K SW 



LOADER DSK 20.574 3K SW 

X Swapping space used > 67/475 : 14X 
X Vlrt, C0f» us«d « 70/475 » 15X 
SwapDing Ratio s 70/39 c l.S 



Busy 


devTcaai 




Oevie* Job 


Why 


LPT 


a 


iNIT 


DTA0 


2 


AS 


DTAi 


13 


AS+INIT 


DTA2 


10 


AS 


DTA3 


« 


AS 


0TA4 


2 


AS 


0TA5 


|2 


AS 


0TA7 


7 


AS 



Syttam rT l*8|ructuras) 
DSKA.OSkBiDSKCi 



TITLE LINE - THE NAME OF SYSTEM AS SPECIFIED IN MONCEN DtALOB 
QUEStieN AND PATCHED AS ASCII TEXT IN LOCATIONS CONFIG,., 
C0NFIG+4i FOLLOWED BY THE TIME OF DAY AND THE DATE. 

CPU USAGE - THE NUMBER OF HOURS, MINUTES, AND SECONDS SINCE 
SYSTEM WAS LOADED INTO CORE, 140 AND 143 RESTARTS DO NOT RESET THIS 
QUANTITY TO ZERO. THE PERCENT OF UP TIME THAT SYSTEM HAS RUNNING THE 
NULL JOB. NULL TIME IS DIVIDED INTO TWO CATEGORIES, IDLE 
AND LOST. The idle time IS THE PERCENT OF UPTIME THAT NO JOB 
WANTED TO RUN, I.E., ALL JOBS WERE HALTED OR WERE IN A WAIT FOR 
SOME DEVICE, THE LOST TIME IS THE PERCENT OF UPTIME THAT THE NULL 
JOB WAS RUNNING BUT AT LEAST ONE OTHER JOB WANTED TO RUN (I.E., 
MAS NOT WAITING FOR A DEVICE) BUT COULD NOT BE RUN BECAUSE OF ONE 
OF THE FOLLOWING CAUSESi 

t. BEING SWAPPED OUT 

2. BEING SWAPPED IN 

3. ON DISK WAITING TO BE SWAPPED IN 

4. MOMENTARILY STOPPED SO DEVICES CAN BECOME INACTIVE 
IN ORDER TO SHUFFLE JOB IN CORE, 

IN A SENSE THE IDLE TIME RATHER THAN ALL OF NULL TIME 
REPRESENTS THE EXCESS CAPACITY OF THE SYSTEM WHICH CAN BE 
ABSORBED BY ADDING MORE USERS, THE LOST TIME CANNOT BE USED 
UNLESS THE JOB MIX IS CHANGED,. 



(8.1 CONT'D) 

JOB DESCRIPTION: 

EACH JOB WHICH IS LOGGED-IN HAS THE FOLLOWING INFORMATION 
TYPED ABOUT ITSELF: 

i, JOB NUMBER (JOB) 

lA, IF THE JOB HAS A HIGH SEGMEMT WHICH HAS BEEN 
SUPERCEDED. AN EACH SIGN (»> IS PRINTED AFTER 
THE JOB NUMBER, 
IB. IF THE JOS IS USING A HIGH SEGMENT WHICH IS FROM A 
DIRECTORY OR DEVICE OTHER THAT THE CUSP DIRECTORY 
ON DEVICE SYS, A NUMBER SIGN (#) IS PRINTED AFTER 
THE JOB NUMBER. 
2, PROJECT-PROGRAMMER NUMBER OF THE USER <WHO>. IF THE USER 

HAS DETACHED HIS TTY FROM THE JOB, •»,•• IS PRINTED INSTEAD 
SO THAT ANOTHER USER CANNOT ATTACH TO THE DETACHED JOB. 
FOR THE OPERATOR AND THE USER HIMSELF, THE NUMBER IS 
PRINTED. 
5, TELETYPE NUMBER JWHERE), CTY MEANS CONSOLE TELETYPE. DET 
MEANS THE TELETYPE HAS BEEN DETACHED FROM THE JOB, 

4, PROGRAM NAME (WHAT) AS SET BY THE GET, RiRUN COMMANDS AND 
THE LOADER CUSP tSETNAM UUO), IT IS USUALLY THE LOW SEGMENT 
NAME. 

5, PROGRAM SIZE (SIZE) IN THOUSANDS (K31024 WORDS) OF WORDS, 
6t JOB STATE AND SWAPPED STATE (STATE) 

tC USER HAS TYPED CONTROL C, JOB HAS HAD ERROR OR EXITED, 

TI TELETYPE ID WAIT 

DI DISK 10 WAIT 

iO ID WAIT FDR ANY OTHER DEVICE 

RN RUNNING (MAYBE SWAPPED OUT OR ON WAY AS WELL AS IN CORE) 

WS WAIT SATISFIED 

TS TTY WAIT SATISFIED 

OS DISK WAIT SATISFIED 

ST SYSTEM TAPE WAIT 

AU ALTER UFO WAIT 

MO MONITOR BUFFER WAIT 

DA DISK ALLOCATION WAIT 

CB DISK CORE BLOCK SCAN WAIT 

DT DECTAPE CONTROL WAIT 

DC DATA CONTROL WAIT 

MT MAGTAPE CONTROL WAIT 

SL PROGRAM IS SLEEPING 

SW LOW SEGMENT IS SWAPPED OR ON WAY IN OR OUT 
SWF LOW SEGMENT IS SWAPPED OR ON WAY IN OR OUT 
AND BECAUSE SWAPPING SPACE IS NEAR FULL THE 
LOW SEGMENT IS FRAGMENTED ON THE DISK, 
7, JOB RUN TIME (RUNTIME) SINCE LOGGED IN, 



(S'.l CONt'D) 

HIGH SEGMENTS 



EACH HIGH SEGMENT CURRENTLY IN AT LEAST ONE JOB'S VIRTUAL 
ADDRESSING SPACE HAS THE FOLLOWING INFORMATION TYPED OUTI 

1. HIGH SEGMENT NAME (PROGRAM), IF THE HIGH SEGMENT IS NOT SHARABLE, 
THE UNLIKELY NAME (PRIV) FOR PRIVATE IS TYPED, IF THE HIGH 
SEGMENT HAS BEEN SUPERCEDED, THE UNLIKELY NAME (OBS) FOR 
OBSOLETE IS TYPED, 

2. DEVICE OR FILE STRUCTURE FROM WHICH THE SEGMENT CAME. 

3. DIRECTORY NAME (OWNER) FROM MHICH THE HIGH SEGMENT CAME, 
IF ONE OF THE JOBS USING THE HIGH SEGMENT IS DETACHED AND 

THE PROJECT-PROGRAMMER NUMBER OF THE HIGH SEGMENT IS THE SAME 
AS HIS. ••••• IS SUBSTITUTED TO FURTHER PROTECT THE USER 
FROM HAVING HIS DETACHED JOB ATTACHED TO BY SOMEONE ELSE. 

4. SIZE OF HIGH SEGMENT (HIGH K) IN THOUSANDS OF WORDS 
(K=1224 WORDS). 

4A, IF HIGH SEGMENT IS SWAPPED OUT AND IS NOT IN CORE. 

SW IS PRINTED, 
4B, IF HIGH SEGMENT IS SWAPPED OUT AND 

IS NOT IN CORE AND IS FRAGMENTED, SWF IS PRINTED. 
4C, IF HIGH SEG IS IN CORE BUT IS FRAGMENTED ON DISK 

TOO. F IS PRINTED, 

5. K'O 01=' USERS IN WHOSE VIRTUAL ADDRESSING SPACE THE 
HIGH SEGMENT APPEARS. 

DORMANT SEGMENTSi 

EACH SHARABLE HIGH SEGMENT WHICH IS CURRENTLY NOT IN ANY JOB'S 
VIRTUAL ADDRESSING SPACE HAS THE FOLLOWING INFORMATION TYPED 
OUTi 

1, HIGH SEGMENT NAME (PROGRAM) 

2. DEVICE NAME FROM WHICH IT CAME, 

3. DIRECTORY NAME (OWNER) FROM WHICH THE HIGH SEGMENT CAME 

4, SIZE OF HIGH SEGMENT (HIGH K) IN THOUSANDS OF WORDS (K=1024 WORDS), 
4A, IF HIGH SEGMENT IS SWAPPED OUT AND IS NOT IN CORE, SW IS 

PRINTED. 
43, If HIGH SEGMENT IS SWAPPED OUT AND IS NOT IN CORE. 

AND IS FRAGMENTED, SWF IS PRINTED, 
4C. IF HIGH SEGMENT IS IN CORE BUT IS FRAGMENTED ON THE 

DISK TOO, F IS PRINTED, 



PERCENT SWAPPING SPACE USED BY ACTIVE AND DORMANT HIGH 
AND LOW SEGMENTS IS COMPUTED BY TAKING THE RATIO OF K OF 
SWAPPING SPACE USED DIVIDED BY THE TOTAL K PREALLOCATEO 
AT REFRESH TIME FOR SWAPPING (EACH HIGH SEGMENT IS ONLY COUNTED 
ONCE). THIS STATISTIC GIVES THE SYSTEM AOMINSTRATOR SOME 
INFORMATION FOR DETERMINING THE OPTIMUM AMOUNT OF SWAPPING 
SPACE TO ASSIGN, TOO MUCH SWAPPING SPACE WASTES DISK SPACEi 
WHILE TOO LITTLE SPACE CAN CAUSE BAD FRAGMENTATION <HENCE SLOW- 
ER SWAPPING) OR EXHAUSTION OF VIRTUAL CORE, 

PERCENT VIRTUAL CORE USED BY ACTIVE HIGH AND LOW SEGMENTS IS 

5OMPUTED BY TAKING THE RATIO OF K OF VIRTUAL CORE USED (EACH 

HIGH SEGMENT IS ONLY COUNTED ONCE NO MATTER HOW MANY USERS 

ARE SHARING AND DORMANT SEGMENTS ARE NOT COUNTED AT ALL) 

piVIOeO BY THE TOTAL K PREALLOCATEO AT REFRESH TIME FOR SWAPPING. 

THIS PERCENTAGE CAN BE HIGHER OR LOWER THAN THE PERCENT OF 

SWAPPING SPACE USED, 

THE SWAPPING RATIO IS A MEASURE OF HOW MANY TIMES PHYSICAL 

CORE IS EXCEED BY THE TOTAL SIZE OF ALL JOBS IN SYSTEM, 

fHE SWAPPING RATIO IS COMPUTED BY TAKING THE RATIO OF K 

OF VIRTUAL CORE USED BY ACTIVE HIGH AND LOW SEGMENTS TO THE 

SIIE.OF USER CORE, EACH ACTIVE HIGH SEGMENT IS ONLY COUNTED ONCE 

AND DORMANT SEGMENTS ARE NOT COUNTED AT ALL). 

IF PHYSICAL CORE EXCEEDS THE CURRENT USACEi THE NUMBER OF K 
OF CORE LEFT IS REPORTED INSTEAD. 

THE PERCENT OF VIRTUAL CORE SAVED BY SHARING IS COMPUTED BY SUM- 
MING THE NO, OF K IN ACTIVE HIGH SEGMENTS MULTIPLIED BY THE NUM- 
BERS OF JOBS MINUS ONE USING THE HIGH SEGMENT AND DIVIDING BY 
THE SUM OF THAT SAME QUANTITY PLUS THE TOTAL VIRTUAL CORE USED. 



BUSY QEVICESI 

i, DEVICE NAME <OEVICE) 

2. JOS NUMBER USING THE DEVICE (DJOB) 

3. HOW DEVICE IS ASSIGNED (WHY) 

ASSIGNED BY CONSOLE ASSIGN COMMAND - AS 
ASSIGNED BY PROGRAM (INIT OR OPEN UUO) - INIT 
ASSIGNED BOTH WAYS - AS+INIT 

SYSTEM FILE STRUCTURES! 

EACH FILE STRUCTURE KNOWN TO THE SYSTEM IS PRINTED, 

SELECTED OUTPUTi 

OFTEN A USER IS ONLY INTERESTED IN PART OF THE OUTPUT, 
ANY SUBSET OF THE OUTPUT MAY BE SELECTED BY TYPING 
ONE OR MORE SINGLE LETTERS AS AN ARGUMENT TO THE SYSTaT 
COMMAND. THE LETTERS MAY BE TYPED IN ANY ORDER, THE LETTERS 
ARE BDFHJS 

B - JUST BUSY DEVICES 

b - DORMANT SEGMENTS 

F - FILE STRUCTURES 

H - EVERYTHING EXCEPT JOB INFORMATION 

J - JUST JOB INFORMATION 

S - SHORT JOB PRINTOUT - STATE AND RUN TIME ARE NOT PRINTED 

EXAMPLEl 

.SYSTAT BD 

PRINTS BUSY DEVICES AND DORMANT SEGMENTS. 



SUBJECTi FAILSAFE VERSION 27 DATE: JUNE 10» 1970 

TOI FROMI Ci MCCOMAS 



THE INFORMATION IN THIS MEMORANDUM IS 
SUBJECT TO CHANGE MITHOUT NOTICE AND 
SHOULD NOT BE CONSTRUED AS A COMMIT- 
MENT BY DIGITAL EQUIPMENT CORPORATION. 



FAILSAFE VERSION 27 

FAILSAFE VERSION 27 AND ALL LATER VERSIOMS ARE DESIGNED TO RUN 
ONLY WITH THE LEVEL D MONITOR, AND ARE INCOHPATIBLE HITH PRECEDING 
MONITOR LEVELS, 

FAILSAFE VERSION 27 DIFFERS FROM FAIUSAFE VERSION 16 (THE LAST LEVEL 
C RELEASE) IN THE FOLLOWING RESPECTS. 

1) THE TAPE FORMAT IS DIFFERENT. THE NEW FORMAT IS AS FOLLOMSl 

HEADER RECORDI XWO VER,4 

(FOLLOWED BY EOF) SIXBIT/»FAILS/ 

XWO <SIXBIT/AFE/>,<T*PE #> 

USUAL FORM OF CREATION TIME « DATE 

XWO 1,2 

WHERE VER* THE POSITIVE VERSION* OF 
THE FAILSAFE USED TO MAKE THE TAPE 

LAST RECORD OF LAST FILE ON EACH TAPE IS A TRAILER RECORD WHICH 
is IDENTICAL TO THE HEADER ON THAT TAPE, EXCEPT WORD 3 RIGHT 
HALF » -TAPE #. 

USER AREA FILES ARE ROUGHLY JUST AS BEFORE EXCEPT THAT INSTEAD 
OF EACH USER HAVING JUST ONE FILE ON THE TAPE CONTAINING ALL 
HIS DISK FILES, HE NOW HAS ONE FILE FOR EACH DISK STRUCtURE ON 
WHICH HE HAS FILES. 

EXAMPLE OF ARRANGEMENT OF USERS ON TAPEJ 

bSKA CI. 13 (DSKA UFD'S) 

dSKA Cl)4] 

bSKA CieiilC] 

DSKA Cli23 

bSKB Cl.l] (DSKB UFD'S) 

bSKB CI, 4] 

bSKB C10i23 

□SKB C10,10] 

DSKB C10>14: 

bSKB Cli23 

bSKB C11.141] 

WITHIN EACH DISK STRUCTURE USER AREA THE FILES ARE THE SAME FORMAT 
AS BEFORE EXCEPT THAT THE OLD * WORD BLOCK IN THE FIRST RECORD 
OF EACH FILE HAS BEEN EXPANDED FROM THE OLD 4 WORD DIRECTORY 
ENTRY LOOKUP TO THE NEW 32 WORD EXTENDED LOOKUP ENTRY, 
IT NOW LOOKS LIKE THISt 

FIRST RECORD OF FILE! XWO -ItN 

SIXBIT/STRUCTURE NAME/ 

32 

USER AREA PRbj-PROG# 

SIXBIT/FILNAM/ 

XMD<SIXBiT/EXT/>iACC, DATE 

PROT, MOQEi GREAT, DATE 

26 MORE WORDS OF LOOKUP INFO, 

FIRST 745 DATA WORDS OF THE FILE 



ia0-i,7a-0i8-(!)0 

UFD'S ARE NOW SAVED, BUT ONLY THE LOOKUP INFO. IS SAVED FOR 
UFD FILES. NO DATA WORDS ARE SAVED FOR UFO'S THE 1,1 AREAS 
CONTAIN ONLY UFD'S « ARE THE FIRST AREA FOR EACH STRUCTURE. 

tHBSC FILES MARKED BY THE MONITOR AS "DO NOT FAILSAFE" FILES 
(SAT. SYS. BADBLK.SYS. ETC) ARE NOT SAVED. '""-"^'^ ''"-ES 

EXCEPT^S^OUOwil '^°""*'"'® *''^ ^"^ ""E *S IN VERSION 16. 

/S SAVES ALL STRUCTURES 

/SDSKA.QSKC.OPAfi SAVES ONLY THOSE STRUCTURES & DEVICES NAMED. 

/U SiVES ALL OF THE USER'S AREAS 

/UDSkB SAVES JUST USER'S AREAS ON NAMED STRUCTURES. 

A MAX. OF 16 ARCS MAY BE USED AFTER /S OR /U. 

RESTORE COMMANDS WORK AS FQLLOWSl 

n„PpSS|BLE EACH FILE IS RESTORED TO THE STRUCTURE IT CAME 
?2?"^. Trl^lLi^ ^" POSSIBLE. AN ATTEMPT IS MADE fo RESTORE 
ir »««^=Jr ^""^ °^"" STRUCTURE) THE ONE WITH THE MOST ROOM 

I r PgSS I dL£ I 

l^^^ul^/J ^?.'^^.t1° "*^ ^^^^ (NCLUDEO. THIS ENABLES THE USER 
♦2r''^nBl'?l a *^° '"'■ COMMANDS FOR A USER OTHER THAN HIMSELF, 
THE FORMAT IS V6MMM,NNN<C,R,> 

l«il ?tlt*°nf lul f'^'^b!:"*" PROJECT-PROGRAMMER NUMBER SWITCH 
FROM THAT OF THE FAILSAFE USER {THE VALUE IT HAS INITIALLY) 
JO MMH.NNN. THIS NEW VALUE IS RETAINED UNTIL *« NEXT /C 

S» OTHER CHANCES IN THE OPERATION OF FaIlSAFEI 

iT'sivti or"es?Jres*'*"'^ ^"^ *°"" "^^ °^ ''"'^^ """''" 

ON RESTORING WITHOUT THE /N SWITCH, FAILSAFE DOES NOT 
OVERWRITE EXISTING DISK FILES WHICH HAVE THE SAME CREATION 
5ATE AND TIME AS A CORRESPONDING FILE ON TAPE. 

4) to RESTORE OLD FORMAT TAPES USE R FAlLCO 
.<,A RESTORE ONLY FAILSAFE FOR RESTORING 

LEVEL c Tapes to a level d disk). 



FLOW CHART FOR /R FOLLOWSl 

Rl READ UFO INFO FROM TAPE 

IF SOURCE FILE STR, NO LONCER EXISTSi GO TO R5 

IF THIS UFD DOES NOT EXIST ON THIS STR.i CO TO R3 
R2I IF NEXT FILE HILL NOT FIT IN EXISTING QUOTA, ERROR 

OTHERWISE GO TO R4 
R3l CREATE A UFO ON THIS STR, kflTH ORIGINAL QUOTA 
R4I RESTORE FILE TO THIS STR. (IF IT FITS) 

IF STR, OVERFLOWS, GO TO R6 

OTHERWISE GO TO R2 

R5! IF THIS UFO DOES EXIST IN SOME OTHER FILE STR, CO TO R8 
R6! IF NO OTHER STRUCTURE EXISTS, ERROR 

CHOOSE EMPTIEST STRUCTURE IN SYSTEM 

CREATE UFD WITH INFINITE QUOTA 
R71 RESTORE NEXT FILE (IF IT FITS) 

IF STR. OVERFLOWS, GO TO R6 

OTHERWISE GO TO R7 

R8: IF NEXT FILE DOES NOT FIT IN QUOTA, GO TO R9 
RESTORE FILE <IF IT FITS) 
IF STR, OVERFLOWS, GO TO R9 
OTHERWISE GO TO Ha 

R9l IF THIS UFO DOES NOT EXIST IN ANY OTHER STR,, ERROR 
OTHERWISE GO TO R8 



100-170-018-00 

FAILSAFE OOCUMENtATION CHANGES 

(CHANGES TO CHAPTER 9, SYSTEM MANAGER'S CUIDEi NOTEBOOK 3) 

PAGE 

5-1 CHANGE •SAT., SYS TO SAT. SYS 

DELETE "EXCEPT UFD'S" ON /S 

ADO PRIHARY FUNCTION /H (AUTOMATICALLY REPEAT 
LAST SAVE FUNCTION AT STATED INTERVALS) 

ADD /C (ENABLE /U. /I, < SELECTIVE RESTORE 
OF AN AREA DIFFERENT FROM THE USER'S) 

5.2 fHC fAPE FORMAT HAS CHANGED AS ABOVE, 

USRCTD BIT IS NOT USED 

S-17 ?2 SETS MTA DENSITY TO 200 BPI (INSTEAD OF /i) 



t00.i.70-0i8.0e 

••« FOR MORE EFFICIENT USE OF FAILSAFE ••• 

WHEN RESTORING AFTER REFRESHING THE DISK, USE THE /N SWITCH TO 

SPEED THINGS UP, E.G.i »/H/n 

THIS AVOIDS DOING A LOOKUP FOR EACH FILE. 

NOTES ON RUNNING FAILSAFE FOR THE N0N-Cl,23 USER 

1) To SAVE ALL HIS FILES ON A TAPE 

•AS MTA# FAILSA 
•R FAILSA 

• /U 

2) to LIST THE NAMES OF HIS FILES ON A FAILSAFE TAPE 

,AS MTA# FAILSA 

.R FAILSA (DIRECTORY GOES TO TTYJ 

• /L 

.AS MTA# FAILSA 

.AS bSK LST 

.R FAILSA 

»/P (DIRECTORY GOES TO DSKIFAILSA.DIR) 

3) TO RESTORE SOME OF HIS FILES TO DISK 

.AS MTA* FAILSA 

.R FAILSA 

••,» (RESTORES ALL FILES) 

OR 

•NAME.* (RESTORES ALL FILES WITH NAME "NAME" 
BUT ARBITRARY EXTENSION) 

OR 

••.EXT (RESTORES ALL FILES WITH EXTENSION "EXT" 
BUT ARBITRARY NAME) 

OR 

•FlL.liFiL,2iFlL.3 (RESTORES SPECIFIED FILES) 



SUBJECT; FAJtCD VERSION 6 DATEi MAY 27, 1970 

^0' FROMl Ci MCCOMAS 



THE INFORMATION IN THIS MEMORANDUM IS 
SUBJECT TO CHANGE WITHOUT NOTICE AND 
SHOULD NOT BE CONSTRUED AS A COMMITp 
MENT BY DIGITAL EQUIPMENT CORPORATION, 



9,00»170. 016-00 

FAILCO VERSION 6 

(ESSENTIALLY THE SAME AS VERSION 1) 

FAILC3 IS A RESTORE ONLY FAILSAFE FOR RESTORING OLD FORMAT 
FAILSAFE TAPES (VERSION 16 i EARLIER) TO A LEVEL SYSTEM. 

ALL FAILSAFE VERSION 16 COMMANDS ARE AVAILABLE 
EXCEPT! 

/S, /Ui /Ml AND /K 

OPERATION IS THE SAME AS FAILSAFE VERSION 16. 

THE NEW /G COMMAND HAS BEEN INCLUDED. THIS ENABLES THE USER 

TO RUN THE /U AND /L COMMANDS FOR A USER OTHER THAN HIMSELF, 

THE FORMAT IS •/GMMM,NNN<C ,R •> 

THIS CHANGES THE SINGLE<USER PROJECT-PROGRAMMER NUMBER SWITCH 

FROM THAT OF THE FAILSAFE USER (THE VALUE IT HAS INITIALLY) 

TO MMMiNNN. THIS NEW VALUE IS RETAINED UNTIL THE NEXT /G 

COMMAND, 

LEVEL C PROTECTION CODES ARE CHANGED TO LEVEL 
PROTECTION CODES AS FOLLOWSl 



LEVEL C 


LEVEL D 


PROTECTION 


PROTECTION 


a 





1 


5 


a 


7 


3 


7 


4 


1 


5 


5 


6 


2 


7 


7 



FILES WITH PROJECT-PROGRAMMER NUMBER 1,1 ARE 
RESTORED (BY BOTH /R i SELECTIVE RESTORE) 
to THE li4 AREA. 



SUBJECTi FAIlDC VERSION 4 DATEl i«|AY 27, 1970 

to: fromi c, mccomas 



THE INFORHATION IN THIS MEMORANDUM IS 
SUBJECT TO CHANGE WITHOUT NOTICE AND 
SHOULD NOT BE CONSTRUED AS A COMMIT- 
MENT BY DIGITAL, EQUIPMENT CORPORATION, 



100. 170. 017^00 

{ESSENTIALLY THE SAKE AS VERSION 1) 
FAILDC VERSJOM 4 

FAILDC IS A SAVE ONLY FAILSAFE FOR SAVING LEVEL 

niSK FILES ON MAGNETIC TAPE IN THE OLD FORMAT (COMPATIBLE 

iilTH FAILSAFE VERSION 16 i EARLIER). 

ALL FAILSAFE VERSION 16 COMMANDS ARE AVAILABLE 

EXCEPT I 

/R AND SELECTIVE RESTORE 

aPERATIO^ IS THE SAME AS FAILSAFE VERSION 16, 

THE NEW /S COMMAND HAS BEEN INCLUDED. THIS ENABLES THE USER 

TO RUN THE /U AND /L COMMANDS FOR A USER OTHER THAN HIMSELF, 

THE FORMAT IS '/GMMMi NNN<C , R, > 

THIS CHANGES THE SINGLE-USER PROJECT-PROGRAMMER NUMBER SWITCH 

FROM THAT OF THE FAILSAFE USER (THE VALUE IT HAS INITIALLY) 

TO MHM.NNN. THIS NEW VALUE IS RETAINED UNTIL THE NEXT /G 

COMMAND, 

LEVEL D PROTECTION CODES ARE CHANGED TO LEVEL C 
PROTECTION CODES AS FOLLOWS! 



LEVEL D 


LEVEL C 


PROTECTION 


PROTECTION 


2 


H 


i 


4 


2 


4 


3 


4 


4 


4 


5 


5 


6 


5 


7 


e 



ALL FILES IN THE 1.4 AREA ARE SAVED (BY BOTH /S i /U> WITH 
PROJECT-PROGRAMMER NUMBER 1,1, 



100-47a-.002-(90 



BOOTS 

Laval Disk Bootstrtb 

Program Daser iptTon 



RavTslen Dstai 10 Juna 70 
Authbri Ri Clatnents 



BOOTS •■ LevsT DlsK Bootstrap •> ].00-47e-002>00 PACE 
10 Jgne 70 



Intpoduetlon 

soots Is a bootstrap program tor use with the lav* I D 
disk servTea of tha POP-i0 t Imashar Ino monTtor. BOOTS has 
two main tunetlonsi 

1) Loading a oroaram Into cora from a disk SAVE fliai 
and 

2) Qumping cora out as a SAVE flla (for latar analysis 
of a orashsd menTtor)i 

BOOTS runs In EXEC mods, oi oeurssi and Is loadad Into 
tha top iK of eora, Qua to tha laek of READ>IN nod* for ths 
yarlsus disk oentroijsrsi BOOTS Is usually Ibadsd from papsr 
taca. 



OPsratJbni 

Tha ODsratlen of BOOTS Is as follewsl 

1) Load paper tape of BOOTS Into Pabar taps reader, 

2) Set READ"IN DEVICE switches to 104> press STOPi 
RESET, READIN, 

3) When paper tape has been read* BOOTS starts and 
types a earrlaoe return, 

.4) type In eommand string, tsrmlnatsd by earrlafla 
return, 

9) After performing the eommand, BOOTS either restarts 
Itself, or transfers to ths newly loaded program, as 
appropriate for the eommand. 



SOOTS • L*V*i' Olsh BootstraD - 100-470.0192-00 PAGE 3 
10 Juni 70 

Cemnand string formati 

Th« general form of a BOOTS command lai 

STRUCTURE :FIUE,EXTCPRO J, PROG VSH ITCH 

For any fields not aupplledi defaults are assumedi The 
SWITCH field determines what operation Is to be performed, 
the STRUgTURC field Is a file strgctwre name wtthin the dIsK 
file syatemi NOT a physical device name, 



AvaTlabTe operations: 

1) NO swlteh • means find the specified fllei clear 
eerei read the file Into core* set the PROGRAM START ADDRESS 
at soieelfled by the fllot and start at that address, I,s,i 
load and run the program. The default FILE name Is 
SYSTEM, SAV, 

2) /L ■ means do all of the abevoi Including setting 
^he PROBRAH START ADDRESS, except do not start the loaded 
pregran, I.a,) Load the program, Default FILE name Is 
SYSTCH.SAV. 

3> /O ■ meant find the specified f||e< write out oore 

(from jeeatTon 20 through the base of BOOTS) onto the file, 

and Mrlta the eurrent PROGRAM START ADDRESS onto the file, 
i',»,t Dumb esre, 

NOTE fHAT THE SPECIFIED FILE MUST ALREADT EXIST) It Is 
updatedt net ereated. The ftlei when readi will not have 
eefreet oheetasums. The default file name Is CRASH,SAVi 

4) /n ■ Mhere "n" Is an octal number - means sat the 
PROGRAM START ADDRESS to n, This command should be used 
prior to dumelng core If the program Is to be loaded and run 
by BOOTS In the future, (This Is net neeessary for dumping 
system crashes,) 

9) /G • means Go to the current PROGRAM START ADDRESS. 



SOOTS - Leva I D Disk Bootstrap - 10Z'>47g.ei02>00 PAGE 4 

10 June 70 



Defaults; 

The default STRUCTURE) Ts OSK: (see "search teehnTsuen 
beloM) I 

The default FILE Is SYSTEM, except tor the /D 
operation/ where It Is CRASH. 



The default .EXT Is .SAV (a b|inK extensTon m«y be 
specified by expllettly typing the dot with no axtenalen 
foi lowlna It), 

The default [PROJ.PROG] Is C1|43, 

The default /SWITCH Ts "none") I,e,, a load and run 

command. 



BOOTS ' L*v»T D Disk Bootstrap • lE!0-47e-002-00 PAGE 
10 June 70 



S*«rch fsehnlqu* 

Boots starches for a soaclflc file structure (e.g.* 
OSKB) by looking for all possible disks fn a predetermined 
order, that order Isi Fha0, FHAI, ..,, fha3. FHB7. ,.,, 
FHB3, DPA0I ,.,• DPA7i DPBa, .,., 0PB7, Note that these 
devices are searohed for a structure name written on the 
de*Tee» not for thetr physical names, BOOTS will not find 
device DPA0, fer example, 

The only exeeotTon to the rule that the STRUCTUREi 
requested must be a defined fl|e structure Is the soeelaj 
case of DSKI (or blank) as a structure name. In thts case, 
BOOTS will search for the file on structures OSKAi, OSKBi, 
OSKCii ...11 DSKOii In that order. As a consequence of this, 
the eofflmon case of dumping a crash on CRASH, SAV would 
attempt to writs the file en DSKA since each structure 
normally, has a file called CRASH. SAV, If the crash Is 
desired en OSKB, (baeauae DSK8 Is larger, for exampje), then 
the DSKBi must be exblleltly typed. 




900TS - Level D Disk Bootstrap - 102-470-002-130 PAGE 6 
IB June 70 

Core B| iocatloni 

aooTS may be assembled tor any size of corei When 

running. It oceucles the too 1000 octal words of the eore 

for Mhlch it Mas assembled. It uses all of the next lower 

10?0 Words as buffersi except for the region from to 137 

In tKat 1000 wordsi which mteht be a Job's JOB DATA AREA 
under a crashed menltori and thus might be needed far 
ana I yzTnq a dump. 

The starting address of BOOTS Is 1000 below the top «f 
eore. For example, 64K BOOTS starts at 177000, 



Recapitulation! 

To dump a crashed system on 0SKBtCRASH,SAVCi,4]i type 

DSKBt/O 

To run a fresh monitor from 0SKlSYSTEH,SAVCli43> type 
Just carriage return. 



UOOKFL.MEM 

V001 

JUNE 18 70 



LOOKFL IS A PROGRAM WHICH DOES AN EXTENDED LOOKUP ON A FILE AND 
PRINTS OUT ALL THE ARGUMENTS, WHEN IT TYPES 

FILEI iTYPE IN A FILE NAME AND RETRIEVE YOUR LISTING FROM DEVICE LPT 
(FILE NAME LOOKFL. TXT), 

FILE NAME HAS FORM DEV INAME,EXTCPR0J,PR0G3 , UFD'S MAY BE SPECIFIED, 
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SRIPe 13 A PROGRAM WHICH READS TEXT FROM ITS USER AND RECORDS IT IN 

4 DISK FILE, THIS ENABLES USERS TO RECORD COMMENTS AND COMPLAINTS. 

TO RUN It, RUN GRIPEi WHEN IT TYPES YES? TYPE ANY TEXT YOU WISH 

TERMINATED BY AN ALTMODE'. THE TEXT IS WRITTEN AS FRE 

CMP###,CMP (### IS A RANDOM NUMBER), CURRENTLY IN THE 3,3 AREA, IT ALSO 

HAS A HEADER INCLUDING THE DATE AND TIME AND USER WRITING THE COMMENT, 
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CODE H*S BEEN ADDED TO DATDMP TO AtLOW A SUBSET OF ITS LISTING TO BE 
PRINTED. IN USER MODE, IT TYPES • AND WAITS FOR THE SUBSET DESIRED TO 
3E TYPED IN, SUBSET MAY BE FIUE,EXTCPR0J,PR0G3 TO LIST ENTRIES FOR 
FILE. EXT CPROJiPROGJ, AMY OR ALL MAY BE •• BUT IF ANY FILE IS SPECIFIED 
AND NO PPN IS SPECIFIED, THE USER'S PPN IS ASSUMED. IF NO FILES OR EXTS 
ARE SPECIFIED, ALL FILES FOR PPN'S SPECIFIED WILL BE LISTED, CARRIAGE 
RETURM GIVES THE WHOLE LISTING <I.E, *.•[», •J), 

FOR THOSE PPN'S SPECIFIED, PPB AND UFO BLOCKS ARE PRINTED, AND FOR FILES 
SPECIFIED, NMB BLOCKS AND ACCESS TABLES ARE PRINTED, THUS, •,MACCia,»3 
LISTS ALL PPB'S AND UFB'S FOR ALL PROGRAMMERS IN PROJECT IB WHO 
CURRENTLY HAVE PPB'S AND GIVES NMB BLOCKS AND ACCESS TABLES FflR ALL 
FILES WITH EXTENSION MAC FOR THOSE PROGRAMMERS, 

IN EXEC MODE, SET LOCATIONS PPNTST, NAMTST, AND EXTTST FOR THE DESIRED 
SUBSET, 

PPNTST CONTAINS PPN'S DESIRED. WITH FOR », 

NAMTST CONTAINS SIXBIT NAME TO CHECK, WITH B FOR •, 

EXTTST CONTAINS 5! FOR • OR. IF NON-HERO, HHsSIXBIT EXT TO CHECK, 

THESE LOCATIONS ARE CLEARED AFTER EACH DUMP SO THAT THEY MUST BE RESET 

EACH TIME. 
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DSKRAT IS A DAMAGE ASSESSMBNT PROGRAM FOR LEVEL DISK FILE 
STRUCTURES. IT SCANS THE FILE STRUCTUREi USING SUPER USETJ'S TO 
READ FILES AND REPORTS ANY INCONSISTENCIES DETECTED TO DEVICE 
LPT (FILE NAME RAT.LST IF LPT IS A DIRECTORY DEVICE), 

TO RUN DSKRAT, LOG IN AS 1,2 (REQUIRED FOR SUPER USETI), ASSIGN A 
FILE STRUCTURE LOGICAL NAME STR, ASSIGN LPT IF YOU WISH IT TO BE 
SOME DEVICE OTHER THAN THE PRINTER, ANO RUN DSKRAT, DSKRAT 
OPENS STR AND LPT, READS SAT BLOCKS INTO CORE AND IF EVERYTHING 
IS ACCEPTABLE TYPES "RUNNING" AND BEGINS TO SCAN THE FILE STRUCTURE, 

FOR EACH FILE ON THE FILE STRUCTURE, DSKRAT LOOKS UP THE FILE 
AND REPORTS ANY FAILURES, READS AND VERIFIES THE FIRST RIB OF 
THE FILE. CHECKSUMS EACH GROUP AND REPORTS ERRORS, READS THE 
RETRIEVAL INFORMATION FROM THE RIB AND CONSTRUCTS ITS OWN SaT 

BLOCKS, IF There are any disagreements between sats 

READ FROM disk AND SATS CONSTRUCTED BY DSKRAT, ERROR MESSAGES ARE 
OUTPUTI I,E. if any cluster IS IN MORE THAN ONE FILE, OR IN A FILE 
BUT NOT MARKED IN THE SAT, THAT FACT IS REPORTED, IDENTIFYING THE 
CLUSTER ANO THE FILE TO MHICH IT BELONGS. ONE LINE IS PRODUCED 
FOR EACH ERROR, INCLUDING THE FILE NAME, CLUSTER NUMBER ANO LOGICAL 
BLOCK NUMBER OF THE CLUSTER IN QUESTION, ANO AN ERROR COMMENT, 

IJHEN DSKRAT HAS GONE COMPLETELY THROUGH THE FILE STRUCTURE, IT PRINTS 
A LIST OF CLUSTERS IN MORE THAN ONE FILE, CLUSTERS IN FILES BUT 
NOT MARKED IN SATS, AND CLUSTERS MARKED IN SATS BUT NOT IN ANY FILE, 
THEN, IF ANY CLUSTERS ARE IN MORE THAT ONE FILE, IT TYPES 

"END OF PASS 1, BEGINNING PASS 2" 

AND STARTS OVER, THE SECOND PASS WILL PRODUCE AN ERROR LINE FOR 
EVERY FILE CLAIMING CLUSTERS USED BY MORE 

THAN ONE FILE (OBVIOUSLY THE FIRST SUCH FILE IS NOT KNOWN IN PASS 
1 UNTIL THE SECOND IS FOUND), IF YOU DO NOT WANT PASS 2, TYPE 
CONTROL C TWICE AND REENTER. THIS WILL CLOSE LPT AND EXIT, 

IF NO CLUSTERS ARE IN MORE THAN ONE FILE, IT TYPES 

"END OF PASS 1, NO NEED FOR PASS 2" 

AND EXITS, 

NOTE THAT SINCE DSKRAT READS IN SATS AT THE BEGINNING OF THE 
PROGRAM, IF OTHER USERS ARE REFERENCING THE DISKS (WRITING QR 
DELETING FILES OR READING FILES MARKED FOR DELETION) THE SAT 
BLOCKS WILL NOT BE CURRENT ANO YOU WILL GET SPURIOUS ERRORS, 
HOWEVER, TRUE ERRORS WILL NOT BE MISSED, 



FlUEX 



FILEX IS A GENERAL ni-E TRANSFER PROGRA-^. IMTENQEO Tc CONVERT 
BETWEEN VARIOUS CtlRp: IMAGE FORMATS AWO TO »EAD AND WRITE 
VARIOUS DECTaPE DIRECTORY FORMATS, AS WfUL AS 5TANDAR0 DISK 
FILESi 

THE COMMaNOS TO FII.EX ARE SlMlUAR TO A PIP CTMManO STRING, 
FILES ARE TRANSFERRED AS 35'BIT BINARY D*TA, NO PROCESSING 
IS DONE ON THE DATA ITSELF, EXCEPT THAT NECE'^SARY TO CONVERT 
BETWEEN VARIOUS CORE IMAGE REPRESENTATloNiS , 

RAPID TAPE PRQCESSlNGi VIA A DISK SCRATCH flLEi IS AvAJLaBlE, 

"HlLO»CARO" FILE NAMES (•» ARE PERMIttEDi 

DEVICE FOHMATS AVAIlaBlEI 

NON-DECTAPE devices are read and WRITTEN IN eiNARV, DEVICE, 
FJLE"NAME» EXTENSION, PROJECT-PROGRAMMER MUmBER, AND PROTECTION 
A»E SUPPLIED IN THE USUAL WAY, 

OECTAPES IN THE USUAL PDP10 DIRECTORY FoRMAT MAY BE READ OR 
WRITTEN IN BINARY IN THE USUAL WAY, AND TMEY MAY BE READ VIA 
A DISK SCRATCH FILE. WHICH IS MUCH FASTER FoR EITHER A TAPE 
WITH MANY FILES, OR A TAPE WHICH HAS BEEN WRITTEN BY TENQMp 
(WITH CONSECUTIVE BLOCKS ALLOCATED TO ThE Same FILE,) 

SIMILARLY, OECTAPES MAY BE READ, WITH OR WITHOUT USE OF A 
SCRATCH FILE. AND MAY BE WRITTEN, IN EITHER THE OLD DEC PDP-6 
OECTAPE FORMAT, OR THE MIT PROJECT MAC pOP6/ie DECTApE FORMAT, 
FOR BOTH or THESE ForHATS, THE MONITOR'S OECTAPE SERVICE 
ROUTINE CANNOT BE MADE TO RUN EFFICIENTLY, SO THE SCRATCH 
FILE TECHNIOUC IS ADVISED, THE /O (OLD) AND /M (MAC) SWITCHES 
SPECIFY THESE FORMATS, /T (TEN) RETURNS TO PDPIB FORMAT TAPES, 

DATA FORMATS AVAlLABLEl 

UNLESS ONE OF THE FOLLOWING SPECIAL FORMATS APPLIES, All FILES 
ARE TRANSFERRED UNMODIFIED, AS 36«BIT BINARY DATA, 

CORE IMAGE FILES ARE THE SPECIAL CASES HANDLED, PROCESSING IS 
AVAILABLE TO CONVERT FROM ANY OF THE FOLLOWING FORMATS TO 
ANY OTHER OF THEM, (OF COURSE, IF THE INPUT AND OUTPUT FOH- 
MATS ARE IDENTICAL, THE FILE IS SIMPLY COPIED,) 



fAC-l OF THE FOLLOWJMG CORE IMAGE FOHMATS JS INOJCATEO 8V 
SPECIFIC EXTENSIONS, WHICH MAY BE 0VER«I00E\ BV SWITCHES, 

1) SAVE-flLE FOR'^An ASSUMED FOR FILES WITW EXTENSIONS 

.SAV, .L0-, AND ,SVE, CAN BE FORCED BY THE /C SkJTCW (COM- 

PRE3SEC rOSE Image.) T-iE default output EXTENSION F0» A /C 
FILF IS .SAV. 

?) EXPANDED CORE Ik^aUE FILE (AS USEO tit FiLODTJl ASSUMED 
FOR FILES WITH EXTENSION ,XPN, CAf- BE FORCED BY THE /E 

SU.ITCH (EXPANDER). The default output extension for a 

/E FILL IS .XPN, 

3) OU>:p format (OLD PDP« VERSION OF SAvE)l ASSUMED FOR FILES 
-ITH extension ,DMP. CAN BE FORCED BY T^-E /D SWITCH, 

«) SBLK FORMAT (SIMPLE BLOCKsPROJECT M^C'S EQUIVALENT OF 
CEC'K ,SaV FORMAT) I NOT ASSUMED FOR A^Y EXTENSION. BUT 
IS FORCED BY THE /$ SWITCH, THE DEFAULT OUTPUT EXTENSION 
F0« 4 /S FILE IS ,B1N, 

5) THE /a SWITCH CAUSES BINARY PROCESSING EVEN THOUGH A FILE 
FILE •^AS ONE OF THESE SPECIAL EXTENSIONS, 

COMMaNU FORMAT! 

A FIlEx COMMAND IS OF THE FORMI 

• nUTPuT SPECIFIER • INPUT SPECiFIEr(S» 

OR 

• OUTPUT SPECIFIER ' INPUT SPEClFIER(S) 

OUTPUT SPECIFIER ISl 

CEVJ NAME .EXT CP,PN]<P(?OT>/S OR . . , CS<1)S(«)S(3) ) 
UHERE /S INDICATES ANY SWITCH a»*»si. JS« o, j 

INPUT SPtCIFItH ISl 

tlEVi NAME .EXT tP.PNj/S, ,,, OR 

DEVI CP,PN]/S NAME ,EXT, NAMEi ,EXT, ,,. 

IF THE CPiPNJ AND/OR /S APPEAR AFTER A OEVICF, ThEV aPPLY 
Ip°P^^'c^L°Y'-?S'TSATV'k'ENAi^,'"'' APPEAR APTER A TILE NAME. THEY 

jARD'pRokss7Na°acc5Rsr' '' •' ■' '^""^^ '''' ''' "*^*^ «'^°' 

THE OUTPUT NAME Ot EXT MAY BE •, IN MICH CASE THE NaME oR 
EXT OF TME INPUT FILE IS COPIED. 



!F TME OUTPUT NAME OB CXT ARE MISSlMGi ALMOST THE SAME OCCURS 
AS FOR •• EXCEPT THAT ALL CORE IMAGE FIlFS WILL BE WRITTEN 
WITH THE BEFaULT EXTENSION AND FORMAT ApPHOPWIATE TO THE OUT- 
PUT DEVICE (UNLESS OVERRIDDEN BY SWITCHES), THAT JS,1 

• OSK: •■DTAll FOO.DMP/0 "OULt CAUSE 

THE OMP FORMAT FILE TO 8E COMPRESSED /C AMD WRITTEN AS FOO.SAV, 

TO CAUSE AN INPUT OECTaPE TO BE PROCESSED QUICKLY (VIA A SCRATCH 
FILE). USE THE /O SwtTCH (FOR QUICK), 

TO CAUSE THE /O PROCESSING AND PRESERVE THE SCRATCH FILE AFTER 
PROCESSInS, for USE 9T ANOTHER COMMAND. USE THE /P (PRESERVED 
nUlCK) SWITCH, 

TO REUSE A SCRATCH FILE PRESERVED BY /P IN A PREVIOUS COMMAND. 
USE THE /R (RE-USE) SWITCH, 

TO IGNORE READ ERRORS ON THE INPUT DEVlcE. USE THE /G (GO ON) 
SWITCH, 

FILEX CHECKS THE ALWAYS-BAD-CHECKSUM BIT IN THE LEVEL D DISK 
FORMAT, SO /G IS NOT NEEDED FOR THOSE FlUES WITH ,RPaBC ON 
(E.G. CRASH, SAV), 

TO COPT A CRASH, SAV TO AN EXPANDED FORMAT FjlE FOR FRODT TO 
EXAMINE. TYPE (FOR EXAMPLES 

DSKI SERteS.SAVCtOitOJ/E-OSKCi CRASH, SAVC1.!!3 

WHILE L0G6ED IN AS lltZZ (TO BE ABLE TO READ CRASH, SAV. WHICH 
IS READ-PROTECTED BY THE REFRESHER), 

THE /i SWITCH ON AN OUTPUT FRE, IF IT IS A DECTAPE. CAUSES 
THE APPROPRIATE FORMAT OF ZEROED DIRECTORY TO BE WRITTEN 
ON THE TAPE. IF THE STRING 

»TAPEID 

APPEARS IN THE OUTPUT SPECIFIER, THEN TaPEID IS WRITTEN AS 
THE TAPE IDENTIFIER IN THE DIRECTORY, TAPEID MAY BE 6 CHA. 
RACTERS ON A POPIB TAPE. S CHARACTERS 0\i A PROJECT MAC TAPE. 
AND IS NOT PRESENT ON A PDP6 TAPE, 

THE /L SWITCH ON AN INPUT DECTAPE FILE CAUSES THE TAPE DIREC' 
TORY TO BE TYPED ON THE TTY, (DO NOT PuT TTYI IN THE OUTPUT 
FILE SPECIFIER, THAT WOULD TRY TO WRITE FILES ON THE TTY IN 
BINARY,) 



SUMMARv or FIUEX SWITCHES 

SWITCH MEANING OfAULT EXTENSION 

1. lEc TAPE Format sPEctftERS 

f- - MAC 

1 - OLD, PDP»* 

T - TEMJ ^ORMAL eOP-ia DIRECTORY FORMAT 

2. FILE fORMAT SPECIFIERS 

3 -, ^iItJAHY| OVERRIDES DEFAULT EXTENSION 
C - COMPRESSEOI SAVED FILE FORMAT SAV 

COM 
SVC 

- DUMP I OLD PDP»6 tJMP 

1 « EXPANiOEO! FOR FJLDOT XPN 
S - S8U«I PROJECT MAC'S SAVE BJN 

3. OEC TAPE PROCESSING SWITCHES 

a - CO 0^» IGNORE READ ERRORS 

L - LlSTt TYPE DIRECTORY ON TTY 

p - PRESERVED! g PLUS KEEP FILE 

g - rUlCK) USE SCRATCH FILE FOR DIRECTORY 

H - i^EUSEI SCRATCH DIRECTORY FROM P 

■i . ?IH0) DECTAPE DIRECTORY 

t^i(l) i,,Nt6)- SPECIFY TAPE IDENTIFIER 
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QUDLST IS A PROGRAM WHICH TYPES OM OfVICE TTY fTS USER'S QUOTAS 
(RESERVEDi FIRST COME FIRST SERVEDi AND LOGGED OUT>, AND BLOCKS 
FRtE WJTH RESPECT TO LOGGED IN QUOTA (RESERVED + FIRST COME FIRST 
SERVED). ONLY THOSE FILE STRUCTURES CURRENTLY IN THE FILE STRUCTURE 
SEARCH LIST ARE CHECKED, 
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PLEASE 



FUNCTION 

tHE PLEASE COMMAND IS AVAILABLE TO P«OVIQE NON-CONFLICTING 
COMMUNICATION BETWEEN AN OPERATOR ANQ SYSTEM USEHS VIA TTY0. 
USE 5F TME PLEASE COMMAND IS PREFERRED TO "TALK OPR" BECAUSE 
PLEASE PREVENTS SIMULTANEOUS TRANSMISSIO'^ TO THE OPERATOR 
VIA TTYZ. 



1, USER INTERFACE 



FOR tHIS DESCRIPTION LET $ REPRESENT <ALTMODE> AND LET • 
REPRESENT ANY ARBITRARY TEXT EXCLUDING CONTROL CHARACTERS, 
THE OPERATION OF PLEASE FOLLOHSl 

USER TYPESI PLEASE •<CR> 

SYSTEM RESPONDSl A) OPERATOR HAS BEEN NOTIFIED 
OR B) OPERATOR BUSY, HANG ON PLEASE 

IN CASE A THE USER MAY IMMEDIATELY BEGIN TWO-WAY TTY COMMUNI- 
CATION WITH THE OPERATOR, COMMUNICATION jS TERMINATED WHEN 
EITHER END TYPES $, IF THE OPERATOR IS BUSY THE USER MAY ELECT 
TO WAIT FOR A MESSAGE AT WHICH TIME HE MAY COMMUNICATE WlTH THE 
OPERATOR, HOWEVER, HE MAY TYPE tC OR S TO ABORT AND RETURN TO 
MONITOR MODE. 
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?. OPERATOR INTERFACE 



TTY0 AT THE COt'PUTER SITE MUST 8E DEDJCATEO TO THE USE Of T+tE 
PLEASE FUNCTION. ONi TTYB THE OPERATOR RECEIVES JOB IDENTlFYjNC 
I\FOPMATIOrJ A:^ID THE USEfl'S MESSAGES AND TRANSWnS HIS fllSPBJjSES., 

THE HASIC FORM OF A PLEASE CONVEIiSATiDN AS IT APPEARS To THE 

OPERATOR I*? shown; BELOWj 

PREAMBLE 

JOB lOEMTIFYIW INFORMATIOW 

PLEASE* 

CCMVEWSATIOrj 

TERMJtWTING >iESSAGE 

THE JOB IDENTIFYING INFOflHATlON IS PUESENTED ASt 

JOe?J CP«0JECTj»,PR0GRA«MER#3 TTYN T1 T2 

THAT IS, THE I^^ITIATING JOB NUMBER, P^fflJECT PROGRAWER NUMBCR 
AND TELETYPE, Tl IS THE TIME THE USEfi TYPED HIS PLEASE REQUEST, 
WHEREAS T2 IS THE TIME THE OPERATOR RECEIVED THE REQUEST, 

WHEN EITHER PARTY TYPES <ALT-MOO£> TME CONVERSATION PORTION 

TERKINATFS, AMD THE TERMINATING MESSAGE "FINISHED T3" IS TYPED 

TO THE OPERATOR, T3 IS NATURALLY THE TIME WHEN TRANSMISSION TERMiNATES. 



UMOUNT.MEM 
PAGE 1 



FIUEJUMOUNT) - INTRODUCTION 

THE FILE COMMAND PROVIDES REMOTE CONTROL OF DECTAPE TO DISK 
AND DISK TO OECTAPE TRANSFERS ON OPERATO'? HANDLED DECTAPES. 
THIS COMMAND ALLOWS OECTAPE TO BE USED A3 CONVENIENT BACKUP 
STORAGE FOR A Sf.ALU DISK SYSTEM. THE COMMAND IS IMPLEMENTED 
IN THE UMOUNT CUSP. - THE USER REUUESTS FILEING OF DATA ONTO 
DECTAPE, AND RECALLING DATA FROM DECTAPE, BY USING THE FILE 
COMMAND, 

THE USER DESCRIBES THE OPERATION HE WISHES PERFORMED* AND 
THEN IS FREE TO DO OTHER WORK WHILE THE OPERATOR HANDLES THE 
TAPE OPERATIONS. HE CAN CHECK ON THE PROGRESS OF HIS REQUESTS, 
BUT IS NOT SPECIFICALLY INFORMED WHEN THE RE3UESTS ARE COM- 
PLETEQ. 

THERE ARE SIX OPERATIONS WHICH CAN BE PERFORMED VIA THE FILE 
COMMANDl F, i. R, L, D AND C, THESE ARE DESCRIBED BELOW. THE 
OTHER ARGUMENTS REQUIRED BY THE FILE COMMAND ARE TAPE ID'S AND 
FILENAMES, THE TAPE ID IS THE IDENTIFICATION NUMBER OF THE 
ROLL OF DECTAPE TO BE USED, THIS IS USUALLY A NUMBER (STARTING 
AT i FOR EACH USER), BUT MAY BE A SHARED TAPE. DESCRIBED 
BY A LETTER AND A NUMBERj FOR EXAMPLE, "AlSS" MIGHT BE A TAPE 
SHARED BY ALL USERS, 

FILENAMES ARE THE USUAL NAME AND EXTENSION PAIR FOR DISK AND 
DECTiPE FILES, THE "•" CONVENTION IS ALSO A LEGAL NAME OR 
EXTENSIONI FOR EXAMPLE, •,MAC MEANS "ALL FILE WITH EXTENSION 
MAC"', 



UHOUNT.MEM 
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1, OPTIONS OF THE FILE COMMAND 

1) F (FOR FILE) OPTIONI THIS OPTION IS A F?EQUEST TO FILE IN- 
FORMATION ON OECTAPE. IT TAKES A TAPE 10 AND A LIST OF 
FILE'JAMES AS ARGUMENTS. 

EXAMPLE! 

.FILE F,l, TEST. MAC, DATA, BIN 

IS A REQUEST TO PUT THE FILES TEST, MAC AND DATA. BIN ONTO ' 
THE USER'S DECTAPE NUMBER 1, AT THE COMPLETION OF THE 
FILE OPERATION. AN AUTOMATIC FILE D {DIRECTORY) COMMAND 
k-ILL BE PERFORMED (SEE BELOW), ALTHOUGH A USER COULD LOGOUT AFTER A 
FILE REUUEST AND EXPECT THE PROCESS TO GO TO COMPLETION 
{IF HE SAVED THE FILES DURING THE LOGOUT DiALOGuEJi THE 
V3?3 PRACTICE IS NOT RECOMMENDED, BECAUSE THE FILES WILL NOT BE DELETED 
VZ?3 FROM THE DISK, 

2) ? (HERO) OPTIONI THIS OPTION IS IDENTICAL TO THE F 
(FILE) OPTION. EXCEPT THAT THE DIRECTORY OF THE OEC- 
TAPE MILL BE CLEARED (HERDED) BEFORE THE FILES ARE 
COPIED, AGAIN, A FILE D COMMAND HILL BE PERFORMED 
AFTER THE FILES ARE COPIED, 

3) R (RECALL) OPTION! THIS OPTION IS A REQUEST TO RECALL 
INFORMATION FROM DECTAPE TO THE DISK, THE ARGUMENTS 
ARE THE SAME AS FOR THE F AND 2 OPTIONS, AGAIN, A 
FILE D COMMAND WILL BE PERFORMED AFTER THE FILES ARE 
TRANSFERRED. 

EXAMPLEl 

■.FILE F,l, •.» , 

IS A REQUEST TO RESTORE ALL FILES FROM THE USER'S DECTAPE 
NUMBER 1, 
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(1 CON'T) 



4) L (LIST DIRECTORY) OPTION: THIS OPTION IS A REQUEST TO READ 
THE DIRECTORY OF A DECTAPE, THE OPTION REQUIRES ONLY 
ONE ARGUMENT, THE DECTAPE TAPE 10, 

EXAMPUEl 

'.FILE D,2 

Is A REQUEST TO READ THE DIRECTORY OF THE USER'S TAPE 
NUMBER 2, THE DIRECTORY WILL BE PLACED IN THE USER'S 
DISK AREA AS AN ASCII FILE WITH THE MAME TAPEID.QIR, 
WHERE TAPEID IS THE NAME OF THE USER'S DECTAPE. THUS, 
IN THE ABOVE EXAMPLE. THE USER MAY READ THE DIRECTORY 
FOR TAPE 2 BY THE MONITOR COMM'AANDi 

.TYPE 2.DIR 

A DIRECTORY OPTION IS PERFORMED AT THE COMPLETION OF 
EACH F, Z, OR R OPTION. 

5) (DELETE) DELETES FILES MENTIONED FROM DECTAPE, 

6) C (CHECK) OPTION) THIS OPTION CAUSES THE QUEUE OF 
FILE COMMANDS TO BE READ TO DETERMINE WHETHER ANY 
OF THE USER'S REQUESTS ARE StILL PENDING. IF NONE 
ARE PENDING, THE MESSAGE "NONE PENDING" IS TYPED, 
IF THERE ARE SOME REQUESTS PENDING, THEY WILL BE 
LISTED, THIS OPTION DOES NOT USE ANY TAPE OR FJLE 
ARGUMENTS, THE CURRENT POSITION IN THE QUEUE OF EACH 
REQUEST IS TYPED AT THE BEGINNING OF THE LINE DESCRIBING 
THAT REQUEST'. 

CXAMPLEl 

.FILE C 

2. DIALOGUE FORM 

"IF THE FILE COMMAND IS EXECUTED WITHOUT AN ARGUMENT, A BRIEF 
DIALOGUE WILL BE PERFORMED. THIS MAY BE EASIER FOR A BEGIN- 
NER to FOLLOW, AN EXAMPLE FOLLOWS! 

.FILE 

C. 0, F, R OR H (7 FOR HELP) 

•F 

TAPE IDl 1 

FILES) A. B. C 

REQUEST STORED 
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1, OPERATOR REQUIRMENTS 

i.l. HARDWARE ENVIRONMENTS 

OPERATION OF THE FItE-RECALL SYSTEM REQUIRES 

A) A DEDICATED DECTAPE DRIVE 

8) A CONTROLLING TTY 

C) DISK FILE STORAGE OF SOME TYPE 

1,1. STARTUP 

THE OPERATOR LOGS IN UNDER CI, 23 ON AN AVAILABLE LOCAL TTY 
AND ASSIGNS ANY PARTICULAR DECTAPE DRIVE SAY 2i TO BE ySED 
BY THE FiLE-RECALL SYSTEM, HE TYPES R OMOUNT AND STARTUP 
is COMPLETE. 

2, OPERATION 

USER REQUESTS ARE STACKED AS ASCII COMMAND FILES UNDER 3.3,UPD 
WITH ORDER OF RECEIPT (AND HENCE EXECUTION) INDICATED BY THE 
COMMAND FILE NAHESi E.G., FlLl.CMDiFIL2.CH0,,., THE PROGRAM 
OPFILE READS THESE REQUESTS IN ORDER, COMMUNICATING WITH 
THE OPERATOR ON THE CONTROLLING TTY, 

A TYPICAL MESSAGE FROM OPFILE IS OF THE FORMI 
PLEASE MOUNT TAPE * FOR USER «,« ON DRIVCl 
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(2. CONT'D) 



THE OPERATOR RETRIEVES THE SPECIFIED DECTAPE 

MOUNTS IT UPON THE PREVIOUSLY 
ASSIGNED DRIVE AND COMMANDS OPFILE TO PRQCEDE BY TYPING THE 
DRIVE NUMBER TERMINATED BY A CARRIAGE RETURN <IN THIS CASE, 2). 
OPFILE REPLIES WITH THE CURRENT ASCII COMMAND FILE AND SIGNIFIES 
COMPLETION OF THE FILE-RECALL OPERATION WITH AN APPROPRIATE 
MESSAGE. 

3, UNUSUAL ACTIONS 

OMOUNT INFORMS THE OPERATOR OF ANY ERRORS OCCURRING WHILE 
TRANSFERRING FILES, THE OPERATOR MAY REPEAT THE CURRENT FILE 
OPERATION BY RESTARTING OMOUNT OR MAY DISCARD THE CURRENT REOUESt 
BY TYPINGI 

♦ C 
.REENTER 

AT THE TIME WHEN OMOUNT IS WAITING FOR A DRIVE «, 
THE OPERATION WOULD APPEAR AS FOLLOWSl 
PLEASE MOUNT TAPE # FOR USER #,n ON DRIVEl fC 

REENTER 

WHEN tC, REENTER IS RECEIVED IN THIS FASHION OPFILE RESPONDS 
BY PRINTING THE DISCARDED COMMAND LINE AND AN APPROPRIATE 
IDENTIFYING MESSAGE, 
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l.ei OCiZe HANDLER 

1.1 BACKGROUND 

THIS SPECIFICATION DESCRIBES THE INITIAL IMPLEMENTATION OF 
THE OC10E DATASEt-CQNTROL SERVICE ROUTINE, AND ITS REQUIRED 
HARDWARE ENVIRONMENT. THIS ROUTINE IS INTENDED AS THE NEC- 
ESSARY LEVEL OF SOFTWARE SUPPORT FOR EARLY DCl«iE'S, FEATURES 
tJESCRIBED HERE WlLL BE EXPANDED UPON IN LATER WORK IN THE 
LOCAL COMMUNICATIONS SOFTWARE PROJECT, 

1.2 HARDWARE ENVIRONMENT 

l,2.i THIS ROUtlNE WILL SUPPORT UP TO FOUR OCiaE DATASET 

HANDLERS ON A DC10 DATALINE SCANNER, EACH LINE TO B£ 
CONNECTED TO THE DC10E IS ASSUMED DO BE A BELL-SYSTEM 
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(1.2.1 CONT'D) 

i03A QATASETi OR ITS EQUIVALENT, 

1.2.2 THE AUTOMATIC-DIALLER FEATURES OF THE DC10E ARE NOT 
SUPPORTED. 

1.3.3 LINE-NUMBERS OF THE EQUIPMENT MUST BE ASSIGNED AS 
FOLLOHSl 

1.2.3.1 THE FIRST Llf<E-GROUP<S> ON THE DC10 (LINES 0-7, 
10.i7i ETC.) ARE ASSIGNED TO DC10B 8-LINE GROUPS, 

1.2.3.2 DCIZE EXPANDED OATASET CONTROLS ARE ASSIGNED TO THE 
NEXT LINE GROUPS IMMEDIATELY ABOVE THE DC10B'S, 

1.2.3.3 ANY SPARE LINE CROUPS HILL BE THE REMAINING HIGHEST- 
NUMBERED LINES (X0-77). 

1.2.3.4 THE ASSOCIATION BETWEEN THE DCIBB LINE NUMBER BY WHICH 
THE DATA IS PASSED, AND TAG OC10E LINE NUMBER BY WHICH 
THE SUPERVISION OF THE DATaSET IS MAINTAINED, IS 
ARBITRARY, THIS ASSOCIATION IS SPECIFIED BY THE 
CUSTOMER TO THE MONITOR VIA THE HONGEN PROGRAM, AND 

IS RETAINED BY THE MONITOR IN A TABLE IN SUB-RQUTINE 
COMMON, THE PHYSICAL NAME "TTYN" OF THE LINE 18 
DETERMINED BY THE DC10B LINE NUMBER, 

1.2.4 EACH LINE OF THE DC10E AND ASSOCIATED OCi0B SHALL BE 
WIRED AS FOLLOWSl (REFERENCE THE DCi0 TECHNICAL MANUAL 
DEC-i0-I8AA.O AS REVISED, AND BELL SYSTEM DATA COM- 
MUNICATIONS TECHNICAL REFERENCE MANUAL. QATa SET 1034 
INTERFACE SPECIFICATION), 

1.2.4.1 CIRCUIT BA, TRANSMITTED DATA, SHALL BE CONNECTED TO 
THE DCIBB CIRCUIT LN PNTR ElA, 

1.2.4.2 CIRCUIT 8B, RECEIVED DATA. SHALL BE CONNECTED TO THE 
DCieB CIRCUIT LN KY6D EIA. 

1.2.4.3 CIRCUITS AA AND AB. SIGNAL GROUND AND PROTECTIVE 
GROUND SHALL bE CONNECTED TO THE DC10E CIRCUIT LN 
AB (GNO), 

1.2.4.4 CIRCUIT CD, DATA TERMINAL READY SHALL BE CONNECTED 
TO THE DC10E CIRCUIT LN DATA DATA TRM ROY EIA, 

1.2.4.5 CIRCUIT CB, CLEAR TO SEND. SHALL BE CONNECTED TO 
THE DC10E CIRCUIT LN CLR TO SND EIA. 

1.2.4.6 CIRCUIT CE, RINGING INDICATOR SHALL BE CONNECTED 
TO THE OC10E CIRCUIT LN RSTRN DETCTD EIA. 

1.2.4.7 _THIS INFORMATION IS DESCRIBED IN FIGURE 2-8-C OF THE 
DCIB MANUAL. 
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1.2.5 THE DATASET AS SUPPLIED BY THE TELEPHONE COMPANY HUST 
HAVE THE FOLLOWING OPTIONS, FOR SATISFACTORY OPERATIONI 

Z.S.i AUTOMATIC ANSWER MUST BE PRESENT, 

2.5.2 INITIATE DISCONNECT MUST BE PRESENT, 

2.5.3 RESPOND TO DISCONNECT MUST BE PRESENT, 

2,5.3 IF THE OATASET IS A 1B3E OR 103G, THEN "CB-CF 
INDICATION COMMON" MUST BE PRESENT. 

1.2.6 THE "DTR OSh SWITCH ON THE CONTROL PANEL OF THE OC10 
MUST BE IN THE ON (UP) POSITION AT ALL TIMES, 

1,3 FUNCtlONS PROVIDED BY THE SOFTWARE! 

1.3.1 iNITIALIZATlONl 

WHEN THE MONITOR IS STARTED (OR RESTARTED), EACH DClBE 
tINE WILL BE INTERROGATED FOR THE PRESENCE OF A CARRIER. 
IF NO CARRIER IS PRESENT, THE DATASET WILL BE HUNG UP. 
IF A CARRIER AS PRESENT, THE OATASET HILL BE LEFT 
ENABLED, IN EITHER CASE, THE STATE OF THE CARRIER 
FLAG IS REMEMBERED IN CORE, 

1.3.2 RESPONSE TO RINGING) 

WHEN. A LINE RINGS, LOCATION "STATES" WILL BE CHECKED 
FOR THE ABSENCE OF SIT 34, UNLESS INHIBITED BY BIT 34 
OF STATES, DATA TERMINAL READY WILL BE SET FOR THIS 
LINE. CAUSING THE CALL TO BE ANSWERED BY THE DATASET, 
I FIFTEEN-SECOND COUNT MILL BE STARTED. SO THAT THE 
CALL MAY BE ABANDONED IF NO CARRIER IS RECEIVED AFTER 
THAT TIME, (THE RIGHT HALF OF LOCATION STATES MAY BE 
■ET TO AN OCTAL NUMBER "N" BY THE MONITOR COMMAND 
"SCHEDULE N" TYPED AT THE OPERATOR'S CONSOLE.) 

1.3.3 RESPONSE TO CARRtER-ONi 

WHEN A CARRIER AS RECEIVED ON A LINE THE RECEIPT OF 
A "CONTROL-C" CHARACTER HILL BE SIMULATED. THERE WILL 
NOT BE AN AUTOMATIC LOGIN OPERATION IN THE INITIAL 
SYSTEM, 

1.3.4 RESPONSE TO CARRtER-OFFi 

WHEN^A CARRIER-OFF SIGNAL IS RECEIVED, ANOTHER 
^CONTROL-C" WILL BE SIMULATED, THERE WILL NOT BE 
AN AUTOMATIC DETACH OR LOGOUT OPERATION IN THE 
INITIAL SYSTEM, 



MONSUP.HAN 
PACE 4 



1.4 iMPLEMENtATIONi 



THE DATA STRUCTURES ASSOCIATED WITH THE DAT*-SETS ARE 
DESCRIBED IN SUBROUTINES COMMON, OLSINT AND MONGEN, 
THERE ARE NO CONDITIONAL ASSEMBUICS ASSOCIATED MlTH 
THE DC10E CODE. BUT TABLE SPACE WILL BE SAVED IT NO 
DC10E IS PRESENT'. 
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2,2 UUO'S 

2.2.1 TEMPORARY FILE STORAGE FOR JOB UUOi TMPCOR (44) 

THE "TMPCOR" UUO IS USED TO ENABLE A JOB TO LEAVE SEVERAL SHORT 
FILES IN CORE FROM THE RUNNING OF ONE USER PROGRAM OR CUSP TO THE 
NEXT, THESE FILES MAY BE REFERRED TO BY A THREE CHARACTER FILE NAME, 
AND ARE UNIQUE TO EACH JOB. I.E. A JOB CAN ONLY REFERENCE ITS OWN 
FILES, ALL FILES ARE ALHAYS DELETED HHEN A JOB IS KILLED. 

EACH FILE APPEARS TO THE USER AS ONE DUMP MODE BUFFER, THE ACTUAL SIZE OF A 
tEMPORARY FlLEi tHE NUMBER OF TEMPORARY FILES A USER CAN HAVE, 
AND THE TOTAL CORE SPACE A USER CAN TIE UP ARE PARAMETERS DETER- 
MINED AT MONGEN TIME, ALL TEMPARARY FILES RESIDE IN A FIXED AREA 
IN THE MSNiTOR. BUT THE SPACE IS DYNAMICALLY ALLOCATED AMOUNG 
DIFFERENT JOBS AND THE SEVERAL DIFFERENT FILES OF ANY GIVEN JOB. 

THE PRIMARY PURPOSE OF THE TEMPORARY STORAGE SYSTEM IS FOR SHORT 
CONTROL FILES, E.G, CCL FILES, TO LIVE IN CORE, THEREBY SPEEDING 
UP RESPONSE TIMES AND REDUCING DISK OPERATIONS, ACCORDINGLY, 
SHOULD A PRObRAM ATTEMPT TO WRITE A FILE WHEN THERE IS 
INSUFFICIENT SPACE, EITHER IN THE ENTIRE BUFFER AREA OR BECAUSE 
THE USER HAS EXCEEDED HIS QUOTA, THE UUO GIVES AN ERROR RETURN, 
THE CUSP CAN THEN WRITE THE DATA AS A SHORT DISK FILE, 
SIMILARLY, SHOULD A PROGRAM FAIL TO FIND A FiUE UPON READING IT, 
IT HILL iSET AN ERROR RETURN AND CAN THEN LOOKUP A SHORT DISK FILE, 

if IS VERY IMPORTANT TO REALIZE THE TEMPORARY NATURE OF THESE 
FILES, FOR CXAHPUi UPON MRItlNG. THE OLD FILE IS DELETED BEFORE 
CHECKING rOR SPACE FOR A NEW VERSION, THE OLD FILE COULD BE LOST WITHOUT 
A NEW ONE RCPLACiNG IT, ALSO, THERE CAN BE NO GUARANTEE THAT FILES 

WILL FIT IN Sore'. 

THE txiPCOl UUO IS NOT intended TO REPLACE A FUTURE, MORE 
OENERALi OEVlCC INDEPENDfiNT SERVICE ROUTINE FOR "CORE". HOWEVER, 
THE SPACE TAKEN UP BY DEVICE OAtA BLOCKS, ETC., IN THAT MORE 
GENERAL HOUtlNC WOULO REPRESENT UNNECESSARY OVERHEAD FOR EXTREMELY 
SHORT DAfAi SUCH AS CCL COMMAND FILES, 
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FORMAT OF TEMPORARY FILE STORAGE UUO. 

CALL AC, CSlxaiT /TMPCOR/] ICALLI INDEX»44 
lERROR RETURN 
INORMAL RETURN 

C(AC) MUST ALWAYS BE SET UP BY THE USER PROGRAM PRIOR TO EXECUTING 
THE UUO. IT IS CHANCEO BY THE UUO AND RETURNS A VALUE THAT DEPENDS 
OK THE PARTICULAR FUNCTION PERFORMED, 

C(AC) ' XND CODE, BLOCK 

BLOCKl XWD NAME,0 INAME IS FILE NAME 

lOWD BUFlEN, BUFFER lUSER BUFFER AREA (ZERO FOR NO BUFFER) 

CODE-a " GET FREE SPACE 

THE IS THE ONLY FORM OF THE TEMP UUO THAT DOES NOT USE A TWO 
»JORO PARAMETER BLOCK, C<AC) WOULD ORDINARLY BE SET TO ZERO FOR THE 
SET FREE SPACE UUO. THE USER PROGRAM ALWAYS GETS A NORMAL RETURN 
<UNLESS THE SYSTEM DOES NOT HAVE THE TEMP UUO). C(AC) IS SET TO 
THE NUMBER OF WORDS OF FREE SPACE AVAILABLE TO THE USER, 

COOE'l " READ FILE 

IF THE SPECIFIED FILE NAME IS NOT FOUND, C<AC> IS SET TO THE 
NUMBER OF FREE WORDS OF SPACE AVIALABLE FOR TEMP FiLESt AND THE 

ERROR Return is taken. 

IF the file IS FDUND, CUC) IS SET TO THE LENGTH OF THE 
FILE IN WORDS, AND AS MUCH OF THE FILE AS HILL FIT IS COPIED INTO 
THE USERS BUFFER. THE USER CAN CHECK FOR TRUNCATION BY COMPARING 
C(AC) WITH BUFLEN UPON SUCCESSFUL RETURN FROM THE TEMP UUO. 

C0DE»2 .- READ AND DELETE FILE 

THIS is THE SAME AS C0DE«1, EXCEPT THAT IF A FILE HAS FOUND 
IT IS ALSO DELETED AND ITS SPACE RECLAIMED. 
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C0DE«3 — WRITE FILE 

IF THERE is ALREADY A FILE OF THE SPECIFIED NAME, IT IS 
DELETED AND ITS SPACE IS RECLAIMED, 

THE REQUESTED SIZE OF THE FILE IS SPECIFIED BY BUFLEN. 
IF THERE IS NOT ENOUGH SPACE TO WRITE THE ENTIRE FILE, NOTHING 
IS HRITTEN, C<AC> IS SET TO THE NUMBER OF FREE WORDS OF SPACE 
AVAILABLE TO THE USER, AND THE ERROR RETURN IS TAKEN, 

IF THERE jS ENOUCH SPACE, THE FILE IS WRITTEN. C(AC) IS SET TO 
THE AMOUNT OF SPACE LEFT AFTER THE FILE HAS BEEN WRITTEN AND THE 
NORMAL RETURN IS TAKEN, FILES ARE ALWAYS FILLED UP WITH ?EROS TQ THE 
NEXT EVEN MULTIPLE OF THE BLOCK LENGTH (tMPBL). 
THIS EVEN LENGTH IS READ BACK IN, 

C00E»4 — READ DIRECTORY 

THE ERROR RETURN IS NEVER TAKEN, 

. CUC).IS SET to THE NUMBER OF DIFFERENT FILES IN THE JOB'S 
TEMPORARY TILE AREA, IN AOOITION, AN ENTRY IS MADE FOR EACH FILE 
IN THE USER BUFFER AREA UNTIL THERE IS NO MORE SPACE OR ALU FILES HAVE 
BEEN LISTED, THE USER PROGRAM CAN CHECK FOR TRUNCATION BY COMPARING 
C<ACJ UPON RETURN WITH BUFLEN, 

DlRCcfORY ENTRY FORMAT 

XHD NAME, SIZE |NAME«FILE NAME, SIZE 'FILE LENGTH IN WORDS. 

bODE»5 — READ AND CLEAR DIRECTORY 

*...It!i! is T**E !*"^ *S CODEt« EXCEPT, THAt ANY FILES IN THE JOB'S 
tCMPOWRY StBRACC AREA ARE ALSO DELETED AND THEIR S^ACE RECLAIMED, 

TNIt UUO is EXECUTED BY THE LOGOUt CUSP, 
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IMPLEMENTATION 

MASTER DIRECTORY 

THIS IS A TABLE JOBN+1 ENTRIES LONG, 

JBTTMPi XWD FREE.IOLE 
J9TTM1! XWD SPACE. LINK 



MREE » NO. OF FREE BLOCKS IN MONITOR BUFFER AREA 

IDLE * LINK TO FIRST FREE BLOCK OR IF NO FREE BLOCKS 

SPACE s NO OF FREE BLOCKS REMAINING IN JOBS QUOTA 

LINK = LINK TO FIRST BLOCK OF FIRST FILE OF JOB, IF NONEi 

IDLE BLOCK FORMAT 

XWO 0,LINK 
REPEAT TMPBLi <0 
> 

LINK a LINK TO NEXT BLOCK ON IDLE CHAIN, IF NO MORC, 

USER BLOCK FORMAT 

XWD NAME, LINK 

SLOCK TMPBL lUSER DATA OR ZERO FILL, 

NAME a USER FILE NAME, 

LINK . LINK TO NEXT BLOCK IN THIS FILE OR NEXT FILE Or THIS USER 

IF A FILE IS SEVERAL BLOCKS LONG, EACH BLOCK HAS THE TILE NAME, 
A LINK OF INDICATES NO MORE DATA IN THE FILE, AND NO HORE FILES 
FOR THIS USER. 

THEREFORE, A FILE ENDS WHEN ITS LAST BLOCK HAS A ZERO LINK, QH 
WHEN IT LINKS TO A FILE OF DIFFERENT NAME, 



MONITOR BUFFER AND PARAMETERS 

TMPBUFI BLOCK TMPBKS«<TMPBL*1> IBUFFER AREA FOR ALL FILES, 

tMPBKS IS THE NUMBER OF BLOCKS THE STORAGE AREA IS COMPUTED, 
IT IS COMPUTED BY MACRO DURING THE ASSEMBLY OF COMMON, 
tMPBL IS A PARAMETER IN S.MAC, 
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PILOPT.FILCHS DETAIUED FLOW FOR OPTIONAL ONCE ONLV 500E 

FILCHG CALLED AS SUBROUTINE tF HANDATORY ONCE ONLY DISCOVERS A NEED TO REFRESH 

• INDICATES SUBROUTINE IN FiLSER (NEEDED AFTER ONCE ONLY) RATHER THAN ONCE 

FILOPTI SET AND CLEAR ALL SOFTWARE FLAGS AND DISH OUERIES CCALL DSKINI*} 

READ ALL HOME BLOCKS FROM ALL UNITS IN SYSTEM AND SETUF STR 8L0CKS(U^PER CASE>CCiLL RE6HOH3 

IGNORE ERROR RETURN 

TYPE "DISK FILE STRUCTURESI" CR-LF 

FILCHOI TYPE ALL STR NAMES AND PHYSICAL UNITS WJTHIN STR CCALL TYPSYS3 
tYPE ALL UNITS NOT IN STRSCCALL TYPUNS3 

ASK FOR STR NAME FOR PARAMETERS TO BE TYPED tCALL ASKPAR3 (LOOP UNTIL CR> 
ASK "DO YOU WANT TO CHANGE ANYTHING (CR IF NOT" CCALL ASKYCR3 
IF CR RETURNi TO RFRLSH 

CHGLUPI ASK IF WANT TO DISSOLVE ANY STRS CCALL ASKDIS3(LOOP UNTIL CR) 

ASK IF WANT TO DEFINE ANY NEW STRS CCALL ASKDEF3(L0OP VNTIL CR> 
ASK FOR STR NAME FOR PARAMETERS tO BE CHANGED CCALL eH6PAR3(L00P ONTtL CR) 
TYPE ALL STR NAMES FOR PARAMETERS TO BE CHANGED CCALU CHOPARS (LOOP UNTIL CR) 
TYPE ALL STR NAMES AND PHYSICAL UNITS WITHIN STR COALL TypSY83 
TYPE ALL UNITS NOT IN STRS CCALL TYRNS3 
TYPE "BEFORE HOME BLOCKS ARE WRITTEN," 

ASK FOR STR NAMES FOR PARAMETERS TO BE TYPED CCALL A9KPAR3 (LOOP UNTtL CR) 
ASK "00 YOU WANT TO CHANGE ANYTHING (CR IF NO)t CCALL ASKYCR3 
IF NOT CRi CHCLUP 

DO SfiN SYS, FOR EVERY UNIT IN SYSTEM 
IF HOME BLOCK NEEDS CHANCING CUNPCHG] 

READ HOME BLOCK 

UPDATE FROM StR AND UNI DATA BLOCKS CCALL H0MUPD3 

REWRITE HOME BLOCK IN BOTH PLACES 

READ HOME BLOCK AND CHECK NAME CH0MNAM3 AND CODE CHOMCODS IN BOTH PLACES CCaCL RCDRUN3 

IF ERROR (BOTH BAO>t HALT 
END 

scnsysi continue 

Type "home blocks written" cr-lf 

fO FiLOPT 

HFRESHI TYPE "TYPE STR NAME TO BE REFRESHED (CR IF NONE)" tCALL ASKSTR3 
ir CR. TO REFEND 

REFRESH SPECIFIED FILE STRUCTURE CCALL REFSTR3 
TO RFRCSH 

REFENDl RETURN 

DSKINI* FLOW FOR ROUTINE TO SET AND CLEAR FLAGS AND QUEDUE9 
PART OF FILSER SINCE CALLED ON ALL RESTARTS, 

CLEAR ALL UNPCHC GLA6S 



REDHOMI OETAlUED TLOW FOR ONCE ONLY READ HOME BLOCKS AND SETUP STR DATA BLOCK 
ROUTINE ALSO CALLED FROM MANDATORY ONCE ONLY CODE 
CHECK ALL CONTROLLERS FOR BEING UP 
SETUP STR DATA BLOCKS 
LINK UNlt DATA BLOCKS TO THEM 
iNlTlALIlE LOCATIONS IN UNI, ICON, STR DATE BLOCK FROM HOME BLOCK 

ERROR RETURN AFTER TYPING ALL UNITS, IF ANY HAVE PROBLEMS 
INlTlAUItE ALL DISK FLAGS, QUEUES, ETC CCALL OSKINI*] CDlNlTF 0] 
SET ONCE DISK INITIALIZATION IN PROGRESS, So ERRORS WILL BE HANDLED QIFF, 
00 SpNUNi, FOR EACH UNIT DATA BLOCK IN SYSTEM CSYSUNi-UNlSYSl 
^ iF CONtROLLER HAS ALREADY BEEN MARKED AS DOWN CKOPOHN«i:, TO FLCONN 
tRYKONI CHECK tO SEE IF CONTROLLER IS OFF-LINE [CALL K0NUPA<K)3 
IF OFF-LtNE RETURN 

TY*E "CONTROLLER XXX |S OFF-LINE, 

"DO YOU WANT IT TO BE (1) ON-LINE. OR (2) DOWN? (TYR#) 
IF NOT "2", TO TRYKON 
FLAG CONTROLLER AS DOWN CKOPOWN] 
TO FLCOHN 
CND 

BiSPiTCH TO ONCE ONLY ROUTINE TO SEE IF UNIT EXISTS AND IS ON-LINE 
IF OFF-UlNE RETURN FOR THIS UNIT 
TyUE "UNIT XXX IS OFF-LINE" 

"00 YOU WANT IT TO BE (1) ON-LINE, {Z» OFF-LINE, OR (3} DOWN <TYA «) 
If ■jit, TO FLCOFL 

ir^NOT "3", TO TRYKON <THE DUMMY MAY HAVE TURNED CONTROLLER Orf) 
FL6DWNI FL^C UNIT AS DOWN tUNYDST-UNVDWN3 
FLGOFLI FLAG UNIT AS OFF-LINE CUNP0FL3 
to SCNLINI 
END 

SIS^ATftH TO ONCE^ONLY ROUTINE INDEXED BY CONTROLLER TYPE TO CHECK WRITE LOCK UNIT 
IF HRITt LOCK RETURN FOR THIS UNIT 
tV^E "UNlt XXX IS WRITE-LOCKEO. 

"00 YOU WANT IT TO BE <1>WRITCABU <2>WRIT£ LOCKED? (TYPE #) 
tr NOT "2", TO TRYKON (THE DUMMY MAY HAVE TURNIO CONTROLLER OF?) 
FLAG UNIT AS WRITE LOCKED CUNPHWP] 
EN6 

RCiO POTH HOMC BLOCKS INTO UPPER CORE ANO PRINT ANY ERRORS [CALL REDRUN3 
tr ERROR RETURN, (SOFTWARE OR HARDWARE ERRORS ON BOTH BLOCKS) 
MARK THIS UNiT AS NOT IN AN STR CUNIttR-B] 
CLEAR LOGICAL UNIT WITHIN STR NAME CUNILOG] 
bLlklt HOHEBLOCK IDENTIFICATION CUNtHlD3 
TO SONUNl 
CN6 
iJOyC PARiMCTERS PROM HOMEBLOCK TO UNtT DATA BLOCK C(ALI. MOVUNI] 

oeTCRHtNf vii lOi SUE OF unit and store in unit data block CUNIBPU] 
■toac type 0^ unit (rpol vs rp02 or rolo vs rmiokunyutp] 

scin, jtr bita blocks (upper core> for matph with str name in hohe block chohsnmj [call fndstr3 

tp pound rcturn, to old str 

crcatc another str data blqck in upper core ccall geistr3 
Append new str oata block to end of str list cstrsysj 

StOKE 6EST1NATI0N (LOWER CORE) ADR, OF STR DATA GLOCK IN SYSTEM TABLE CTABSTR3 
StpRE (iieXT FREE FILE STRUCTURE NUMBER {N THIS FILEtTR OaTA BLOCK (STRFSN3 
MOVE FOLLOWING PARAMETERS fROM HOME BLOCK tO STR DATA BLOCK CCALL M0VSTR3 



OLDStRI IF THIS IS LAST UNIT IN STR CHOMNXT.B] 

IF NO, OF UNITS IN STR HAS ALREADY BEEN STORED INTO CSTRUNHl 
TYPE "STR XXX HAS MORE THAN ONE LAST UNIT" 
SET ERROR RETURN FLAG 
SET STR NEEDS REFRESHING CRH<STRREF)3 
to SCNUNl 
END 

STORE NO, OF UNITS IN THIS STR CSTRNUM*UNILUN«13 
END 

DO SCNUNS, FOR EACH UNIT DATA BLOCK JN THIS STR SO FAR CSTRUNI'UNISTRS 
IF LOG UNIT NO. OF NEXT UNIT IN THIS STR CUNILUN3 IS GREATER, TO INSERT 
SCNUNSI CONTINUE 

APPEND THIS UNIT DATA BLOCK TO END OF UNIT LiST FOR STRC8TRUNI3 
TO SETUNS 

INSERT! INSERT UNIT DATA BLOCK JUST READ IN FRONT OF FIRST UNIT LARGER 
SETUNSI SET UNIT DATA BLOCK tO POINT UPWARD tO ITS STR DATA BLOCK tRH<UNlSTR)3 
SCNUNl t CONTINUE 

DO CHKSTR, FOR EACH STR IN SYSTEM [SYSSTR-STRSYS3 
IF LAST UNIT IN STR WASN'T READ CSTRNUM»B3 

TYPE "LAST UNIT HASN'T FOUND IN STR XXX" 
SET ERROR RETURN FLAG 
END 

SET STR NEEDS REFRESHING CRHJSTRREF) 
END 

SET NO, OF BLOCKS JN STR TO -NO, OF BLOCKS FOR SHAPP|NSCSTRH6H*STRK4S«BLKBPK3 
00 CHICUN-S FDR EACH UNIT DATA BLOOK IN ThIS STR 

Increase no, of block is str by number in this UNiTcsTRGH-sfRHOH ♦ unibpuj 

IF NEXT unit is MORE THAN ONE LOGICAL UNtT HIGHER 
tYPE "LOGICAL UNIT N MISSING FROM STR COR" 
SET ERROR RETURN FLAG 
SET STR NEEDS REFRESHINGtRHCSTRRCF) 
END 

IF NEXT UNIT IS SAME AS PREVIOUS UNIT 
TYPE "TEND LOGICAL UNIT U FOUND IN STR AAA" 
SET ERROR REtURN FLAG 
SET STR NEED REGRESHlNS [RH(STRRCF> 
END 
CHKUNII CONTINUE 
CHKStRi CONTINUE 

IF ERROR WHILE READING A UNIT, ERROR RETURN 
OK RETURN 



PNDSTR-ONCE only routine TO SEARCH STR DATA BLOCKS (UPPER CORE) 

ARE-8TR NAME 

VAL-ADR, OF STR DATA BLOCK IN UPPER, 

VAL-ADR OF PREDESSOR <MAYBE«SYSStR IN LOWER CORE) 

VAL-SYSTEM STR # 

NO SKIP RETURN IF CANNOT FIND STR 
FNDSTRJ DO SCNSTR, FOR ALL STR DATA BLOCKS (UPPER CORE) tSYSSTR-STRSYS] 

IF FIND MATCH tSTRNAM], OK RETURN UPPER CORE ADR, THIS * PREO 
SCNSTRl CONTINUE 

ERROR RETURN 



SUSROUtlNE TO READ OOUBLEY WRITTEN SPECIAL BLOCKS CREORUN] 

AR6S LOGICAL BLOCKS NOS, OF EACH 

SIXBIT NAME CHECK AND FOR ERROR MESSAGE 
SPECIAL CODE TO CHECK FOR 
ADDRESS OF WHERE TO READ 
UNIT DATA BLOCK ADDRESS 
ERROR RETURN OR CM RETURN 

ONCE ONLY IN PROGRESS CDINIZE IS NOT EQUAL TO 0] 
READ SECOND BLOCK 
IF HiRDHAAE ERROR 

SET LIGHTS TO CONTROLLER STATUS WORD STORED IN UNIT DATA BLOCK BY FILSER 

TYI>E "HARDWARE ERROR-SECOND XXX BLOCK ON YYYN 
END 
iF NAHE WORD OR CODE WOfiO 00 NOT AGREE 

TYf»E "CONSISTANCY ERROR-SECOND XXX BLOCK ON YYYN 
END 

READ FIRST BLOCK 
if HAROMjkRE ERROR 
SET LlSHtS TO CONTROLLER STATUS WORD STORED IN UNIT DATA BLOCK BY FILSEN 

TVI^E "HARDWARE ERROR-FIRST XXX BLOCK ON YYYN 
END 
IF NAME WORD OR CODE WORD DO NOT AGREE 

TYPE "CONSISTANCY ERROR-FIRST XXX BLOCK ON YYYN 
iND 

If NCIfHJCR BAD ERROR, OK RETURX 
If flRST BLOCK WAS BAD BUT SECOND BLOCK WAS GOOD 

fl£AO SECOND BLOCK 

t)K tttURN 

iw 

ERR OR RCtURN 

TYPJUS-ROUTINE TO TYPE ALL STRS AND UNITS IN STR9 IN SYSTEM 
fVRSYli 00 T^PALLi FOR ALL StR DATA BLOCKS (UPPER CORE>tSYSSTR-StRSYS] 

tY#E tHIS STR NAME, IF NEEDS RCFRESHINS, PHYSICAL (AND LOGICAL) UNITS [CALL TYPSTR3 
tV^AlLi iONtlNUE 

AETURN 

fYPltRiROUTINE TO PRINT STR NAMEi IF NEEDS REFRESHING, PHYSICAL (AND LOGICAL NAMES) 
ARG-iOORCSS or STR DATA BLOCK (UPPER CORE) 

tYPStRi !F TdlS tTR NEEDS REFRESHING tRHiSTRRET)], TYPE "NEEDS REFRESHING!" 
TYPf 8tR NAHI C8TRNAM3 
50 t9PUNli FOR ALL UNIT DATA BLOCKS (LOWER CORE) IN THIS STR CSTRUNI-UNISTRJ 

tr FtRit TJME Thru loop 

fTPC "I" 
ELSE 

tYPt"," 
CNii 

iyH PHYSICAL UNIT NAME CUNINAM3 
TYPE "i" 
tV#E UNIT HOME ID NAME CUNlHIOJ 

ty^E •>" 

fYfUNii dONtlNUE 

TYPE CR-Lr 
kETuRN 



CHGPARI 



EXAMPLEI 

NEEDS REFRESH INGJDSK*lFHAa(>,FHAH).rH*2|) 

OSKBlDPA0<P03),DPAl(P07),DPA2<NX375) 

TYPUNS-ROUTlNE TO TYPE ALU PHYSICAL UNITS NOT IN AN STR 

TYPUNSI tYPE "UNJTS NOT IN A FILE STRUCTUREIWCR-LF 

DO SCNUNI. FOR ALL UNIT DATA BLOCKS (LOWER CORE) IN SYSTEM tSYSUNl-UNISYSJ 
IF THIS UNIT IS NOT IN AN STR EUNISTR.ai 

IF THIS IS NOT THE FIRST TIME THROUGH LOOP. TYPE "," 
TYPE PHYSICAL UNIT NAME CUNINAM3 
TYPE "<" 

Un "»"^ "^' ''*"^ CUNIHiOJ {TYPE NOTHING BETWEEN PAR IF 0) 
END 
SCNUNII ^ONTiNUE 

TYPE CR-LF 
RETURN 

ASKPARiCHGPAR-ROUTINES TO TYPE OR TYPE/CHANCE PARAMETERS 
!F''cR''JEtSR!"ETURN " ""*'*'" '" PA^A^tERS (CRiNONE. 0»K.ALL)teALL A8KSTRJ 

^?^v^^^r,^Jr^S''iSIi'<^ S^" S*""'^NT. VALME, type N«IH value or CR", CR-LF 

to ASKLUP ROUTINE HILL TYPE AND CHANGE PARAMETERS tTyPONL*03 

ASKPARI fp^''g^"J^?g„STR^NAME^FOR LIST OF STR PARAMETERS (CR-NONE, OSK-ALLKCALL AIKSTR3 

fr4lSS*S*^^?PE'§ [J'':ggRE%°^'^g?uSiE'fej'"'^^ '''' nn,,trtHs tTvPONi-n 

DO SCNSTR, FOR ALL STR DATA BLOCKS (UPPER CORE) 
TYPE STR NAME CSTR NAM] 

SCNSTR, CONTINUE ""''' "*"*"'"" ''' '"" "" ''''' ''""'' 
RETURN 
ELSE 

PRINT PARAMETERS FOR STR [CALL TYPPAR] 
END 

IF TYPONL SET, TO ASKPAR 
TO CHGPAR 

jR8-"S?°0?'MissSGr''^ """"^ *^° *''"" *" '^*"^ *'*" ''""'< '^ '■'*'»*'■ 
VAL-ADORESS OF STR DATA BLOCKl, IF OSK TYPED 
VAL-ADDRESS OF PREOESSOR, STR DATA BLOCK (MAYBE SYSSTR) 
RET-NON-SKtP IF CR, REPEAT QUESTION IF NOt A VALID STr TYPED 

ASKStRl .TYPE MESSAGE WHICH JS PASSED AS AN ARGUMENT 
ACCEPT INPUT FROM CTY 
IF CR, NO SKIP RETURN 

IF "pSK" HAS TYPED, GIVE SKIP RETURN WITH VALUE 
SEARCH UPPER CORE FOR STR DATA BLOCK CCALL FNDSTR] 
IF NOT FOUND RETURN, TO ASKSTR (ASK QUESTION AGAIN) 
OK RETURN 



typp*r-routlne to type or type/change parameters 

!f cjtvponu) is nonzero parameters are typed 

if cjtypontj is zero parameters are typed and changes are accepted 

ar6-adr, of file structure data block <upper core) 

Typpari Type "parameters mhich may be changed without refreshing, "cr-lf 
ask »n0, consecutive clusters tried for on sequential ouput«" 

Type its value and accept change ccall askdecj 
IF no change or cr or type only return, to ASKBGA 

DO SfiNUNi, for A|.L UNITS IN THIS STR 

...unu.i -^u.?!!!?^ ^^" '*"'' °^ CLUSTERS tried ON OUTPUT FOR THJS STR CLH(UNIGRP>3 
SCNUNII CONTINUE 

ASKBGAI ask "SUM. of blocks GUARRANTEEO to users.", value CSTRGAR3, ACCEPT DEC CCALL ASKDEC3 
IF NO CHANGE. OR CR OR TYPE ONLY RETURN, TO ASKBOU ASROECJ 

• TORE NO', OF BLOCKS GUARRANTEEO FOR THIS STR CSTR GAR] 



ASKBOUi ASK "NO, OF BLOCKS OVERDRAW/USEH«", VALUE C-STROVR], ACCEPT DEC NO. 
IF NO CH/kNGE, OR CR, OR TYPE ONLY RETURN, TO ASKNSC 



ECALL ASKDEC] 



ASK I 



ITORC NO, OF BLOCKS OVERDRAW PER USER FOR THIS STR C-SIROVR] 

ASK "MO OF SAT BLOCKS IN CORE PER UNIT««, VALUE CUNY 
TY"" "■— 



«-i- -i.,, "^ °°^^ ''E" UNIT.", VALUE 

YPPiR"CONT 

.,i.^.m llli !!*!i2^I5"L""'''" REQUIRE REFRESHING IN ORDER TO CHANGE I "CR-LF 
ASKK4SI TYPE. "K FOR SWAPPING ON LAST UNIT-", VALUECSTRK4S3, ACCEPT DECCCALL A8KDEC3 
IF NO CHiNGE, CR, OR TYPE ONLY RETURN, TO TYPBPC 
!F ViLUE EXCEEDS LAST UNIT CVALU?«BLKBPK EXCEEDS UNYBPU3 

TYPE "IHAPPING CANNOT EXCEED LAST UNIT»",VALUECUNY8PU/BLKBPK] 
TO ASKK48 
CND 
iTORl NO", OF K FOR SWAPPING ON THIS STRCtTRK4SII 

*r.S2,',J^ hS^**? ^^ ^S'^ ^^'' ^0 "N"' "f BLOCKS FOR SWAPPING CSTRHOH— STRK4S.BLKBPK3 
00 SeNUNi, FOR ALL UNIT DATA BLOCKS IN THIS STR 

?i;i2»I!!i'.,!!'"!.*2. 5SS^""NG home block to be rewritteneunpchg] 

. , INORCASE no. of BLOCKS IN STR BY NO OF BLOCKS PER UNIT 
SCNUNII eONTlNUC 

AIKBPCI iJXrBliOSKS/eUUSTERi", TYPE VALUE CUNYBPC3. ACCEPT DEC, tCALL ASK0EC3 
F NO CHANCCi CR, OR TYPE ONLY RETURN TO TYPBCA 
F VALUE IS lERO. TYPE "CANNOT BE 18", TO ASKBPC 

Ch)!i^!if*52SE52'M!!"'2 L'M'T CLiMBPC3. type "cannot exceed NNN" CTYPOEC], to ASKBPC 
#:S %?r:rao?Sc S^r^ES^S^G^KH^^^R^J^?,;" ^^"^ ""'^ °*^* ^^°^« c5nYB*C3CCALL ST0UNi3 
eOMPytl ll«E OF OLUStER ADDRESS FIELD FOR REtRlEVAL POINTERS 

tIE MAX, NO. Bits TO REPRESENT LAST CLUSTER ON UNlTr«UN|BPU-i)/UNIBPC33 
rUiINC ^FFO ^'IND FIRST 1, SUBTRACT FROM S« GIVES NO. OF BITS REQU RE03 
STORE NUMBER OF BITS REOU|REP FOR CLUSTER ADDRESS CBIT9 ».ii STRCLP3 
ITORp: NUMBER OF BLOCKS PER SUPER CLUSTER CSTRBSC^UNYBPQaU il8TRHGH"B)/(2tlB))*13 
JJORI NUMBER OF SUPER CLUSTERS PER UNIT tSTRBCUH <UNl8PU-l>/8TRB8c'ii3 

" ♦13 

1 



flHnji nunsi-n wr suriR buuSTfeRS rtH UNIT CSTRCCU*) (UNIBPU-l)/STRB8C)*t3 
•TORE NO. OF CLUSTERS PER SAT BLOCK CSTrsSZ*H|N<128»34, (i|UNIBPU«i)/UNYBPC>*] 

SlcaS multiple sat per unit flag cun*msb3 for au UNITS In stR c8all STOVNI! 



IF MORE THAN! SAT BLOCK PER-UNIT Ct2B«3ft LCtS THAN (< JQNIBPU-ll?UNYIMm)3. 

SET MULTIPLE SAT PER UNIT FLAG CUNPMIb! FOR ALL UNITS !n STS JCALL StOuSU 

END 

TYPBCAI TYPE "THEREFORE BITS/CLUSTER AOR>", VALUECB!T8 4-il STRCLPKCALt TY^DECJ 
TYPE "THEREFORE HOROS/SAT.", VALUEC<<ITRSSZ«l)/36)*13fCALL tVPOCCJ 
TYPE "THEREFORE BLOCKS/SUPER CLUSTER"", VALUECSTR8SC3CCALL tyPpECJ 
TYPE "THEREFORE SATS/UNIT.",VALUEE( < (UNIBPU«n/UNrBPU»<'<i88«S6) >*13i:eALL TYP6EC3 



ASKBCCI 



TVPPiR-CONT 

TYPE "BITS/CLUSTER COUNT*", VALUEtBITS 6-11 STRCNP3. ACCEPT OECCCALL ASK DEC] 
F NO CHANGE CR, OR TYPE ONLY RETURN. TO TYPBCK 
iF VALUE IS Z, TYPE "CANNOT BE 0", TO ASKBCC 
IF VALUE IS GREATER THAN UPPER L IMITtHMCNP»183, OR 36,p(BlTS 6-.il STRCLP) 

tYPE "CANNOT EXCEED", MIN(L1HCNP, 36-<BITS 6-H STRCLP) >ECALL TYPDEC3 

TO ASKBCC 
END 

IZl R?iH?^O^rB:rAgfe"^?'^ASr?lE[D'fegllg SEI-'ilXiL^SPTERS.CBITS ^-U. STYCNP^VALUED 
STORE NO, OF BITS PER CHECKSUM FIELD IN RET, 
STORE RIGHT MOST BIT AOR OF SAME FIELD CBITS 



a-5 STYCNP«.36,-BITS 6-li STYCNP] 

PTRCBITS 6.11 STYCKI**36,-BITS 6-11 STRCNP-BlTS 6-11 STYCLP3 

0»5 STYCKP*BITS 0-5 STYCNP*BITS 6-11 STYCKP3 



TYPBCKI tYPE "THEREFORE BITS/CHECKSUM»", VALUE [BITS 6-11 STYCKP3CCALL TYPDEC3 



4SKDEC - ROUTINE TO PRINT MESSAGE, DECIMAL NO, ANY ACCEPT A, DEC, VALUE 
NO SKIP RETURN IF CR, VALUES ARE SAME, OR TYPONL FLAG ON 
REPEATS MESSAGE IF NOT A DECIMAL NUMBER 
ARCS - DEC, NO., ADR, OF MESSAGE 

ASKDECI SAVE ADDRESS OF MESSAGE IN CASE ERROR AND VALUE PASSED 

ASKAGNI TYPE MESSAGE PASSED AS AN ARGUMENT AND TYPE VALUE CCALL TYPDEC3 

ACCEPT DECIMAL INPUT CCALL GETOEC] 

IF ERROR RETURN, RESTORE MESSAGE AOR AND VALUE. TO ASKACN 

jF INPUT MINUSCCR), NO SKIP RETURN 

IF ORIGINAL VALUE AND THIS ONE ARE SAME, NO SKIP RETURN 

SKIP RETURN 

TYPDEC - ROUTINE TO TYPE MESSAGE AND DECIMAL VALUE 

TYPDECI TYPE MESSAGE PASSED AS ARGUMENT 

TYPE DECIMAL VALUE PASSED AS ARGUMENT CCALL TYPNUM3 
RETURN 

GETOEC - ROUTINE TO ACCEPT DECIMAL NO. 

ERROR RETURN IF NOT A DECIMAL NUMBER 

RETURN - VALUE VALUE»-1 IF CR TYPED OR TYPE ONLY FLAG ON 

GETDECI IF TYPE ONLY FLAG 0NCTYP0NL»-1], SKIP RETURN HITH -I VALUE 

GET NEXT CHAR 

IF CR, SKIP RETURN WITH -1 VALUE 

SET VALUE TO 
CHRLUPI IF NOT A NUMBER, ERROR RETURN 

MULTIPLY VALUE BY la AND ADD THIS CHAR - "0" 

GET NEXT CHAR 

iF CR, SKIP RETURN WiTH VALUE 

fO CHRLUP 

STOUNI . ROUTINE TO STORE A BYTE IN ALL UNIT OAT* BLOCKS 
MITHIN AN StR 
ARGS . ADDRESS OF STR DATA BLOCK 

- VALUE TO BE STORED 

- BYTE POINTER WITH INDEX U 

STOUNII DO SCNUNi, FOR ALL UNITS IN THIS STR 
STORE VALUE USING BYTE POINTER 
FLAG THIS UNIT AS NEEDING HOME BLOCK REWRITTEN BECAUSE CHANCECUNPCHGJ 



iSKDIS - FLOW FOR ONCE ONLY SUBROUTINE TO ASK ABOUT DISSOLVING STRS 

NO ARCS, NO VALUESi LOOPS UNTIL DONE 

ON LINKS UNIT DATA BLOCKS (LOWER CORE) RETURNS STR DATA BLOCKS (UPPER CORE) TO FREE STORAGE 

ASKDiSJ ASK t-TVPE STR NAME TO DISSOLVE (CR IF NONE. OSK IF ALL>"i ACCEPT AND CHECK STRCCALL ASKSTR3 
IF OR RETURNi RETURN 
IF "bSK WAS TYPED C0 ADDRESS RETURNED^ 

DO SCN8TR, FOR ALL STR DATA BLOCKS (UPPER CORE) 
»-.,-*- - OISSOLVE THIS STR AND UNLINK UNIT DATA BLOCKS CCALL DISSTR] 
SCNSTRI CONTINUE 
REtURN 
ELSE 

DISSOLVE THIS STR AND UNLINK UNiT DATA BLOCKS CCALL DISSTR3 
END 
fO AIKOIS 

OISStR « FLOW FOR ONCE ONLY SUBROUTINE TO DISSOLVE AN STR 

ARC . ADDRESS OF STR DATA BLOCK (UPPER CORE), ADDRESS OF PREDESSOR (RETURNED BY ASKSTR) 

VOL « NONE 

DISSTRi 60 SCNUNIi FOR ALL UNIT DATA BLOCKS (LOWER CORE) IN STR tO BE DISSOLVEDCSTRUNI-UNISTR] 
MARK UNIT AS NOT IN AN STRCUNlSTR*B,UNtL0G«a3 
MAAK UNIT AS NEEDING REFRESHING CUNPREF*!] 
SCNStRl CONTINUE 

(PRCBEISOR RETURNED BY ASKSTR FROM FNDSTR) 

MAKE .PREbESSOR StR BLOCK POINT TO STR OAtA BLOCK AFTER STR BEING DISSOLVED 

. tLH(fTRSYS(PREDESSOR))-LH(STRSYS(STR BEING DISSOLVED))] 

RETURN STR tO FREE StORAGE (SPACE WILL BE REUSED If NEEDED)tCALL 3 

RETUdN 

ASKDiCF • FLOW FOR ONCIE ONLY SUBROUTINE TO ASK ABOUT OEFlNINC STRS 

NO ARC» NO VALUES. LOOP UNTIL DONE 

CREATES STR DATA BLOCKS (UPPER CORE) AND LINKS UNIT OATA BLOCKS (LOWER CORE) 

ASkOEfi fYPE,"tyPE STR NAME tO DEFINE A NEW ONE(OR IF NONE)* 
iCCE#T INPUt FROM CT» 
jr OfiLT ftR TVPED. REtURN 

1HECK TO. SEE IP THlS STR NAME ALREADY E)(iSTSCCALL TNBSTRJ 
r NOT POUNOi TO OEFNCW 
VPC »StR NAME ALREAbY EXISTS* CR-LF 
AtKbEP 



OEFNEWI GET FREE COREtUPPEB CORE) FOR STR DAtA BLOCKtCALL WHICH CLEARS IT] 

(UASt STR OAtA BLOCK RETURNED BY FNDSTR) 

LINK LAST STR DATA BLOCK TO THIS NEH ONE(SUBtRACT OFFSET BEFORE STORtNG)[STRSYS] 

REMEMBER STR DATA BLOCK ADDRESS (UPPER CORE) AS IF UNIT DATA BLOCK 
ASKNXTl ASK "TYPE NEXT PHYSICAL UNITICR WHEN OONC)''tCALL A9KUNI] 

IF CR RETURNi RETURN 

APPEND THIS UNIT DATA BLOCK tO LAST ONE IN THIS STRCSTRUNI-UNISTRJ 

REMEMBER THIS ONE AS NEW LAST ONE 

MAKE SURE THIS UNIT IS FLAGGED AS LAST UNITCLHISTRUND-B] 

SET fHlS UNITS UPWARD POINTER TO POINT TO SIR PATA BL0CKCRH<8TRUN1 >3 

STORE UNIT LOGICAL NUMBER WITHIN STRtUNYLUN«.8TRUNM3 

STORE UNIT LOGICAL NAME WITHIN STRtUNIL08»STRNAMlSTRUNM3 

INCREASE HIGHEST LOGICAL BLOCK IN THIS StRCSTRHGH«STRHGH*UN|BPU] 

INCREASE NUMBER OF UNITS IN THIS STRtSTRUNH3(LAST 80 CAN USE ABOVE A LOGICAL NO',) 
TO ASKNXT 

aSKUNI • FLOW FOR ONCE ONLY SUBROUTINE TO ASK FOR PHYSICAL UNIT 

ARG ■ MESSAGE ADDRESS 

VAL > UNIT DATA BLOCK ADDRESS (LOWER CORE) 

NO SKIP RETURN IF JUST CR TYPED 

ASKUNI I REMEMBER MESSAGE ADDRESS IN CASE ERROR 
ASKAGNI tYPE MESSAGE PASSED AS AN ARGUMENT 

ACCEPT CTY INPUT 

IF JUST CRi NO SKIP RETURN 

SCAN UNIT OAtA BLOCKS LOOKING FOR MATCHCCALL FNDUNI3 

IF NOT FOUND RETURN 

TYPE "NOT A PHYSICAL UNIT" 
TO ASKAGN 

END 

SKIP RETURN 

PNDUNI • FLOW FOR ONCE ONLY SUBROUTINE TO FIND UNIT DATA BLOCK ADR 

ARG • PHYSICAL NAME 

VEL - UNIT OATA BLOCK ADDRESS (LOWER CORE) 

NO SKIP RETURN IF NOt FOUND 

FNDUNII DO SCNUNii FOR ALL UNITS IN SYSTEM C8YSUNI-UNI8YI3 

IF FIND MATCH CUNINAM3i OK RETURN 
SCNUMI CONTINUE 

ERROR REtURN 



iFlLrLO.MEM ; ENGLISH TLOH CHARTS FOR FltSER - va05 3 DEC 69 
ITHE ENGLISH FLOH CHARTS AND SUPPORTING OOCUMEMTATION 
I Is KEPT AS A SEPARATE FILE WHICH CAN BE ASSEHBLED WITH FILSER 
LO6IC*«0 IMAKC COMMENTS BE IGNORED 



repeat logic. < 

■add lots or < to allow < and > during the text) end with lots of > 

Table of contents 

SYMBOLIC parameter DEFINiTIONS » APPEAR IN A SEPERATE FILE NAHED DSKPAR.MAC, 
tHEY DEFINE ALL tABLE AND DISK BLOCK LAYOUTS AND ARE THE SOLE SOURCE 
or THAt •PEClFlCATlON, IT SEEMS BETTER TO HAVE ONLY ONE PLACE FOR SUCH 
DOCUMCNTATtON WHiCH MUST BE CORRECT RATHER THAN 2 PLACES WHICH CAN DIFFER, 

1', IMfLEMENTATtON POLICY AND IMPLEMENTATION GOALS 

2', ACCUHULATQR USAGE 

3°, SEOUENCtNS OF OPERATIONS 

4', uiio FLOM In uuocon 

INTER 
COWUf 
INPUT C4.0SC 
QUtFUT CLOSE 
iMlt 

9\ uilO FLOW In FlLSER 
LOOKUP 

iCNtt* 

output 

*, ClOtSiRV 



1. iMPLtMENTATlON POLICY iMPLEMENTAtjON COALS 

i, TRY TO MAKE UUO'S .RESTARTABI.E AT. ANY TlMt 

A, ESPECIALLY BETWEEN |0 WAITS 

B, BETWEEN INSTRUCTIONS 

UUP CODE MUST NOT MODIFY DATA BASE IN DDB UNTIl. *,E2°fiFi^S«tJ*' 
REACHED SUCCESSFUL TERMINATION. SAME IDEA HOLDS TOR UUOCON 
AND UUO PROGRESS BITS, 

2, MAKE CODE DEFENSIVE, FOR EXAMPLE INPUT TtSTS THAT DaTA 
iN ObB IS SELF CONSISTENT, IF POSSIBLE. 

3, DON'T TRUST HARDWARE, BUT DEMAND THAT HARDWARE STATUS CORRESi 
POND TO COMPUTED EXPCCTEO STATUS OR REMEMBERED STATUS, 

4, KEEP MAXIMUM AMOUNT OF DEVICE STATUS INFORMATION IN CORE", 

k, MAKES INITIAL DEBUCGING EASIER 

B. FACILITltATES PROGRAM MAINTENANCE. 

5, TRY to MAKE AS MUCH DATA SWAPPABLE AS POSSIBLE INCLUDING 
MOST OF DATA IN OSKDDB'S 

6, MAKE PROGRAM EASfER TO MAINTAIN BY 

A, SHARPLY DEFINED MODULES 

B, CONVENTIONAL CALLING SEQUENCES 

V002 1. DEFINE PJRST TO BE OPCODE<S',MAC> TO REPLACE PUSHJ 
V002 POPJ PAIR AT END OF A SUBROUTINE INSTEAD OF USING 

V002 JRST; JRST will remain To BE USED FOR TRANSFER 

V002 OF CONTROL TO TAGS WHICH ARE NOT SUBROUTINES. 

V0JIZ 2. USE MACRO IStOPCP ARC) INSTEAD OF HALT FOR HALTS". 

vSil In s'.mac define arg as an octal symbol use one 

V002 HALT CODE PER EACH StOPCD, DEFINE STOPCO AS 

7002 ANY OFI HALT 
V002 UUO 

V002 JFCL 

C, ACCUMULATOR CONVENTIONS 



2, ACCUMULATOR USAGE 

2,1 INTER MODULE CONVENTION 

VB0Z THE DISK SERVICE HILL BE DIVIDED INTO 2B OR SO MODULES, THESE 
V0e2 MODULES WILL FULLOVi THE FOLLOWING SUBROUTINE CONVENTION WHEN 
VBB2 CALLiNG EACH OTHER, SECTION 2.2 DESCRIBES TWO EXCEPTIONS WHICH 
VB02 ARE ALLOWED ONLY WITHIN MODULES. 

WE DEFINITELY REQUIRE A MORE DISCIPLINED USE OF ACCUMULATORS 
WiTHiN THE MONITOR NOT ONLY TO REDUCE EXTRANEOUS PUSH'S AND POP'S 
BUT ALSO TO ENABLE ALL SUBROUTINES TO ASSUME INTEGRITY OF DATA 
In AC'S, THREE CLASSES OF ACCUMULATORS ARE DEFINEDj 

1, GLOBAL 

a, TEMPORARY 

3, PRESERVED 

GLOBAL ACCUMULATORS SUCH AS THE CURRENT F,P,R 

ALWAYS CONTAIN THE SAME TYPE OF INFORMATION, ONLY A SELECT 

SET OF ROUTINES EVER EXPLICITLY MODIFIES THE CONTENTS OF 

GLOBAL AC'S, GLOBAL ACS ARE IMPLICIT ARGUMENTS TO MANY ROUTINES'. 

TEMPORARY ACCUMULATORS SUCH AS CURRENT T,T1, ETC.i ARE USED FOR 
WORKING STORAGE AS WELL AS BEING THE STANDARD PLACE TO PASS 
ARGUMENTS AND RETURN VALUES, 

PRESERVED ACCUMULATORS FORM A NEW AND MUCH NEEDED CLASS, 
PREStRVED AC'S MAY BE USED AS DESIRED AFTER BEING SAVED, THEIR 
INTEGRITY IS ASSURED AS ALL SYSTEM SUBROUTINES WILL USE A 
COMMON SET OF ROUTINES TO SAVE AND RESTORE THESE AC'S, THEY 
VB02 WILL NOT BE USED TO RETURN VALUES, HOWEVER THEY MAY BE USED 
V0a2 to PASS ikRGUMENTS WHEN THE QUANTITIES ARE THE TYPE OF THING WHICH 
V002 WANT TO STAY AROUND ACCROSS A NUMBER OF SUBROUTINE CALLS, 

SUBROUTINES SAVli SAV2i SAV3 AND SAV4 WILL BE USED TO PRESERVE 

ii 2, 3 OR 4 OF THE COMMON PRESERVED AC'S, PRESERVED AC'S MUST BE 

USED IN ORDERt THAT-Is IF ONE IS REQUIRED Pi IS USEQi IF TWO 

ARE AEQUtREO PI* P2 ARE USED AFTER CALLING SAVli SAV2 RESPECTIVELY, 

THE STANbARO POPJ P. OR JRST CPOPJl RETURNS WILL RESTORE ALL 

OF tME PRESERVED AC'S UPON EXIT RELIEVING EACH SUBROUTINE 

OF tdAT tEDieUS DUTY', 

V003 THE NAMES OF AUL SUBROUTINES SATISFYING THESE CONVENTIONS WILL 

V003 CONTAIN SIX CHARACTERS, WHILE VIOLATORS OF CONVENTION (SEE 2,2> 

VB03 WILL BE GIVEN 5 OR FEWER CHAR NAMES, THIS HAKES IT CLEAR TO 

V003 fHE READER WHEN HE SEES A PUSHJ WHAT IS WHAT WITHOUT GOING TO 

V003 fHE SUBROUTINE, 



EXAMPLE OF AC SAVING ROUTINE AND USE 
SUBRI JSP TSiSAVZ 
JRST CPOPJl 

SAV2I PUSH P. PI 
PUSH P.P2 
PUSHJ P,(T3) 
JRST .+Z 
AGS • 2(P) 
POP P.P2 
POP P»P1 
POPJ P. 



Vea2 NO SUBROUTINE WtUU "POP UP MORE THAN ONE LEVEL" ON A RETURN, 

VBBZ tPOPJ AND TPOPJl MAY BE USED ONLY FOR POPPING OFF DATA {RATHER 

Va?6 THAN A RETURN). THUS THE PROGRAM FLOW IS ALWAYS APPARANT 

VZ06 to THE READER BECAUSE IT ALWAYS RETURNS IMMEDIATELY AFTER 

V006 PUSHJ OR ONE LOCATION AFTER IT IF SUSROUTINE CAN SlVE A SKIP RETURN. 

NO SUBROUTINE WILL PASS ARGUMENTS OR RETURN VALUES 

ON THE PUSH DOWN LIST, NO SUBROUTINE WILL 

LEAVE THE PUSHDOWN LIST IN A DIFFERENT CONDITION 

OR DiFFERENT DEPTH THAN WHEN IT WAS CALLED. 

(EXCEPT OF COURSE SUCH ROUTINES AS SAV1.,.SAV4> 

CP0PJ,CP0PJ1, TPOPJ, AND TPOPJl WHICH EXIST 

SOLELY FOR THE PURPOSES OF HANDLING THE PUSH DOWN LIST, 

2.2 INTRA MODULE CONVENTIONS 

V002 BECAUSE tHE ABOVE CONVENTIONS 00 USE UP INSTRUCTIONS (PUSH'S AND 
V0e2 POP'S AND MOVE TiPl ETC,) AND PUSHDOWN LIST SPACE, THE 
V0B2 rOLLQWiNG TWO EXCEPTIONS ARE ALLOWED) 

V003 (THfSE SUBROUTINES ARE FLAGGED BY GIVING THEM FIVE OR FEWER 
SYMBOUS IN THEIR NAMES,} 

V002' A, A SUBROUTINE (AND ALL THE ONES IT CALLS) MAY BE DESIGNED 

V002 TO RESPECT THE CONTENTS OF SPECIFIED TEMPORARY ACS, RESPECT 

VB02 MEANS THAT A SUBROUTINE (AND ALL THE ONES IT CALLS) EITHER DO 

Vee2 NOT CHANGE THE CONTENTS OF AN AC (IT MAY OR HAY NOT BE AN 

V002 AftGUMCNT) OR IT PUSH'S IT BEFORE MODIFICATION AND POP'S IT 

VB02 BrFORC RETURN', WHEN THIS IS THE CASE THE COMMENTS AT THE 

VB02 BEGtNNiNC OF THE SUBROUTINE WILL SAY! 

V002 Wi'THIS SUB, AND ALL THE ONES IT CALLS RESPECT THE CONTENTS 

V002 or tEMP ACS T1,T3," n FOR EXAMPLE 

VBSS. I, A SUBROUTINE MAY RETURN A VALUE IN A PRESERVED AC (SO THAT 
VBflS THE AC IS NOT PRESERVED). THIS EXCEPTION WILL ALSO BE 
V003 CLEARLY STATED AT THE BEGINNING OF A SUBROUTINE. THIS TECH- 
VOaS NJOUE WILL BE USED INFREQUENTLY AND WILL BE USED FOR SETTING 
VB(3 UP A PRESERVED AC FOR A RELATIVELY GLOBAL QUANTITY WITHIN 
V003 A MODULE. 

V0B3 ALL JRST'S HiLL BE TO TAGS DOWN PAGE, EXCEPT LOOPS, THUS FLOW 
V003 GOES DOWN THE PAGE, AND THE READER HAY START AT THE BEGINNING 

OF THE CiOOE AND READ THE PROGRAM WITHOUT BECOMING CONFUSED 

ABOUf tHC- PROGRAM FLOW. 



ACCUMULATOR USAGE 



OLD NAME 



t 
t 

INTERRUPT AND 
UUO LEVELS 



IDS 

POP 

ITEM 

PROG 

DEVDAT 

DAT 



INTERRUPT AND 


TAG 


UUO LEVELS 


TACl 




TEM 


t 


OSER 



UCHN 
UUO 

AC! 
AC2 
AC3 
8UFWRD 



NEW NAME 

S 

P 

u 

B 
F 
C 

T 
Tl 
T2 
T3 

UCHN 
UUO 

PI 
P2 
P3 
P4 



NEW ASSIGNMENT 



e 
1 

2 

3 
4 

5 


f 
• 

GLOBAL 
♦ 


6 

7 

10 

11 


TEMPORARY 
t 


12 
13 


GLOBAL 


14 
15 


♦ 
"PRESERVED" 


17 





V0B4 TYPING CONVENTIONS! 

V0e4 ONE TAB INSTEAD OF ONE SPACE BETWEEN INSTR. AND AC 

V004 MULTI-LINE COMMENTS WILL BE INDICATED BY ONE SPACE 

VB04 AFTER THE SEMI COLON ON ALL BUT THE TIRST LINE. 

V004 SUBROUTINE WILL BE PRECEDED MlTH A DESCRIPTION OP 

V0e4 FUNCTION. ARGS, AND VALUES, THE WORD "SUBROUTINE" 

V004 WILL BE THE FIRST WORD ON THE FIRST LINE, 

V0B4 TAGS WHICH APPEAR FIRST ON A PAGE AND THEREBY 

V004 LOOK LIKE SUBROUTINES WILL BE INDICATED 

V004 OTHERWISE BY A COMMENT STARTING AT LEFT 

V004 MARGIN STARTING WITH WORD "HERE". 

MOST TAGS WILL BE PHECEOeO BY A FULL LINE COMMENT 

STARTING WITH "IHERE TO . . , "TO DESCRIBE WHAT 

THE CODE IS ABOUT TO DO OR "IHERE WHEN ... "TO 

DESCRIBE THE CONDITIONS WHICH CAUSED CONTROL TO 

GOT TO THE Tag 
V004 THE INSTRUCTION OF A NON-SKIP SUBROUTINE RETURN WILL 

V004 BE INDENTED 2 SPACES SO THE READER WILL 

V004 BE ABLE TO TELL SUCH SUBROUTINES WHICH HAVE 2 

V004 RETURNS. 

ALL SUBROUTINES WILL BE PRECEDED BY COMMENTS STARTING AT LEFT MARGIN 

WITH "SUBROUTINE TO ...", ALONG WITH PESORIPTtON OF ARCS 

ALSO ANY IMPORTANT OVERVIEW COMMENTS, 
ALL TAGS WHICH ARE LOOPS WILL BE PRECEDED BY A FULL LINE COMMENT 

"LOOP TO .." DESCRIBING WHAT THE LOOP IS DOING 
IF THERE ARE ANY TAGS (VIOLATIONS OF JRST DOWN PAGE) WHICH ARE TRANSFERRED 

TO FROM FURTHER DOWN THE PACE, SHALL INDICATE THIS BY A PRECEDING 

FULL LINE COMMENT "BACK HERE TO .,, " 



3, SEQUENCING OF OPERATIONS 

THE OPERATIOMS OF THE FILE SYSTE^« WILL BE CAREFULLY DESIGNED SO THAT 
A SYSTEM CRASH AT ANY TIME WILL NOT LEAVE THE DISK IN A STATE WHICH 
WILL CAUSE MORE INFORMATION TO BE LOST, THUS THE ORDER OF WRITING DISK 
BLOCKS OF FILES WHICH DESCRIBE THE FILE STRUCTURE IS IMPORTANT (MFD, 
UFO, SAT, RIB), ALSO IMPORTANT IS THE ORDER IN WHICH CORE MEMORY LOCAT- 
IONS ARE UPDATED AND CHANGED. AN ATTEMPT WILL BE MADE TO ALLOW A JOB 
TO BE STOPPED (CONTROL C) OR RESCHEDULED AT ANY TIME DURING DISK 10 PR 
BETWEEN ANY TWO INSTRUCTIONS. THE NO SCHEDULE, 5CWEDULE MACRO WILL BE 
USED AROUND GROUPS OF INSTRUCTIONS FOR WHICH NO SCHEDULING (AND, 
THEREFORE STOPPING OF THIS JOB) CAN OCCUR. SOME D»TA LOCATIONS ARE CHANGED 
AT UUO AMD INTERRUPT LOCATIONS. THE NUMBER OF SUCH LOCATIONS SHALL BE 
MINIMIZES AND SHALL BE CLEARLY LABELLED. 

THE DISK SERVICE WILL BE PROGRAMMED SO THAT IT WILL 9E ABLE TO RECOVER 
FROM ANY CONDITION IN WHICH THE USER TYPED CONTROL C AND STARTED 
HIS PROGRAM OVER AGAIN. TO ASSIST IN THIS, EACH ACCESS TABLE ENTRY 
(ONE PER ACTIVE OR DORMANT FILE) AND EACH DDB (ONE PER ACTIVE FILE- 
USER PAIR) WiLL HAVE A SIMPLE STATE CODE IN IT, RATHER THAN BITS, SO 
THAT A SIMPLE DISPATCH ON PREVIOUS STATE CODE WHEN AN EVENT OCCURS 
WILL MAKE SURE THAT ALL POSSIBILITIES ARE ACCOUNTED FOR. IF ANY SE- 

ouENCE OF Instructions (no io wait) must be executed without interrupt 
then the noshedule, schedule macro will be used, 

sequencing of disk block writes 

this problem becomes more difficult because the optimization code will 
not necessarily write blocks in the order in which they are queued, 
the problem becomes even more complex when different speed devices are 
part of the same file structure (e.g., drum and bryant disk), however 
a request to write a given block followed by a request to read the 
Same block wIll always occur in first come first serve order, 

order of reading, writing, and read pause write of blocks 

<> mean possible repeated reads or writes. exit from loop not neces- 
SARILY At BOtTOM, 

C] MEAN MAY 8E UNNECESSARY BECAUSE OF RETRIEVED INFORMATION IN CORE. 
The REASON IS INDICATED IN A SECOND SET OF BRACKETS. 
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FILE, UNIT, CHANNEL* CONTROLLER STATUS 



V003 
Vei03 
V003 
V003 
V0i?3 
VB?3 

V0e3 
vzes 

V003 



V003 

vaes 

V003 

veez 

V003 
V003 
V003 
V003 

V003 

V003 
V003 
V003 
VZ03 
V003 
V003 
V003 
V003 



I - IDLE 

SW • SEEK WAIT - POSITIONING DUE TO SEEK UUOi OF NO OaTA 

TRANSFER AFTER 
S - SEEK 

PW - POSITION WAIT 
P - POSITION 
TW - TRANSFER WAIT 
t - TRANSFERRING 

WAIT MEANS FILE IS IN SEEK/POSITtON QUEUE FOR UNIT OR TRANSFER 
eUEUE FOR CHANNEL 



V003 NOT ALL ENTITIES CAN BE IN ALL STATESl 





FILE 


UNIT 
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SW 




SW 
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PW 


PW 


PW 
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TW 


TW 


TW 
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CHANNEL KONTROLLER 
I I 



B STANDS FOR BUSY AND HAPPENS WHEN A OATA TRANSFER 

IF A UNIT IS IN SW, ONLY ONE FILE CAN 8E IN QUEUE 
ANO IT IS LEFT IN IDLE STATE, THE ONLY HAY 
A UNIT CAN GET INTO SEEK WAIT IS iF THE CONTROLLER 
IS BUSY WHEN A USER DOES A SEEK UUO. SUBSEQUENT 
SEEKS OR POSITIONS FOR THE SAME OR DIFFERENT FILES 
ON THE SAME UNIT WILL CAUSE THE SEEK/POSITION 
QUEUE FOR THE UNIT (ONLY ONE FILE WHEN UNIT IN SN) 
TO BE CLEARED), 
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READ A FILE 



LOOKUP 



INPUT 
CLOSE 



CREAb MFD RIBKNEVER NEEDED BECAUSE MFD ALWAYS HAS A DDBl 

t<READ MFD BLOCK>C]NOT NEEDED IF JBTUFD ENTRY] 

CREAb UFO RIBKWJ 

[READ UFO BLOCK>3CN0T NEEDED IF FILE ACTIVE OR DORMANT] 

<CREAD FILE RIB3CN0T NEEDED IF SHORT LOOKUP OR MEDIUM LOOK- 
UP AND FILE WAS ACTIVE OR 00RMANT3 

<READ FILE BLOCK» 

C'REAO-PAUSE-WRITE RIB3CN0T NEEDED UNLESS FIRST ACCESS OF DAY 
AND INPUTS D0NE3 



CREATE A FILE. SUPERSEDE INDICATED BY • 

ENTER CREAD MFD RIBKNEVER NEEDED BECAUSE MFD ALWAYS HAS A DOB] 

[READ MFD BL0CK>3CN0T NEEDED IF JBTUFD ENTRY] 

CREAO UFO RIBJCS 

CREAO UFO BLOCK>3CN0T NEEDED SINCE FILE ACTIVE OR DORMANT 

•CREAO FILE RIBJCNOT NEEDED SINCE FILE DOESN'T EXIST ON A CREATE 

[READ SAT BLOCKJCNOT NEEDED IF SAT TABLE ALREADY IN CORE] 

<WRltE NEW RIB BLOCK> 
OUTPUT«<WRITE FILE BLOCK> 

CWRlfE OTHER SAT BLOCK READ SAT BLOCK]>CNOT NEEDCO (F SaT tABLE 
ALREADY IN CORE] 

READ-PAUSE-HRITE RIB BLOCK> 

CREAO SAT BL0CK3CN0T NEEDED IF SAT TABLE NOT DIFFERENT FROM DISK] 
CLOSE WRITE PARTIAL FILE BLOCK 

READ-PAUSE-WRITE NEW FILE RIB BLOCK 

CWRITE SAT TABLE3CN0T NEEDED IF NOT DIFFERENT FROM 0ISK3 

READ-PAUSE-WRITE UFD BLOCK 

<REAO OLD FILE RlB BLOCK 

CCWRlTE OTHER SAt BL0CK3CNOT NEEDED IF MOT DIFFERENT FROM DISK] 

•HEAD SAt TABLE3]CN0T NEEDED IF SAT TABLE ALREADY IN CORE] 

•WRITE SAT TABLE) 



APPENDING, UPDATE A FILE 

LOOKUP CREAb MFD RIBK 

[<READ HFD BLOCK>K 
CREAb UFD RIBlf] 
C'<READ U^D BLOCK>] 

C'READ FILE RIBKNOT NEEDED IF SHORT LOOKUP OR 
MEDIUM LOOKUP AND FILE WAS ACTIVE OR DORMANT] 
ENTER <CREAD FILE RIB3CN0T NEEDED IF RIB ALREADY READ BY LOOKUP OR 

MEOiUM ENTRY AND FILE WAS ACTIVE OR D0RMANT3 
INPUT «REAO FILE BLOCK» 

CWRlfE AI.LOCATED BUT UNWRITTEN3>CN0T NEEDED UNLESS USER OVER- 
SHOOTS ON AN APPEND] 
OUTPUT«<WHltE FILE aLOCK> 

CHRltE OTHER SAT BLOCK 

READ SAT BL0CK3>CN0T NEEDED UNLESS APPENDING AND DESIRED SAT NOT IN CORE] 
READ-PAUSE-WRITE RIB BLOCK> 
CLOSE CREAD-PAUSE-WRITE RIB BLOCK]tNOT NEEDED UNLESS RIB CHANGED OR 
FIRST ACCESS OF DAY] 
tWRlTE SAT TABLE3CN0T NEEDED IF NOT DIFFERENT FROM DISK] 

RENAME A FILE PREVIOUSLY CLOSED 

LOOKUP SAME AS READ IN OLD DIRECTORY 

RENAME CLOORUP iN NEW UFD3CN0T NECESSARY IF OLD AND NEW UFD ARE THE SAHE3 

READ-PAUSE-NRITE CNEH3 UFD 

CREAO-^AUSE-HRITC OLD UF03CN0T NECESSARY IF OLD AND NEW UFD 
ARE THE SAME] 

READ-PAUSE-WRITE FILE RIB 



RENAME A FILE BEING CREAYED 

ENtER iAME A8 CREATE IN OLO DIRECTORY ^ . „ „ , 

RENAME [LOOKUP IN NEW UPD3CN0T NECESSARY IF OLD AND NEW UFD ARE THE SAME! 

READ-PAUBE-WRITE CNEWl UFD 

REiD-PAUtE-WRITE FILE RIB 



DELETE A FILE PREVIOUSLY CLOSED 

LOOKUP SAME AS READ 

RENAME CREAb-PAUSE-WRITE UFD] 

«CCMRITE OTHER SAT BL0CK3CN0T NEEDED IF NOT DIFFERENT FROM DISK! 

READ SAT BLOCK]]>CNOt NEEDED IF SAT TABLE ALREADY IN C0RE3 

READ RIB> 

DELETE A FILE BEIN5 CREATED 

LOOKUP SAME AS READ 

F?ENAME «[CWRITE OTHER SAT BLOCKJtBUT NEEDED IF NOT DIFFERENT FROM DISK! 
READ SAT BLOCK33>CNOT NEEDED IF SAT TABLE ALREADY IN CORt 



4, UUOCQN FLOM 

ENtER (UUO LEVEL - UUOCON) 

PREPiRE to SUPPRESS INPUT CLOSE 

IF FiLE OPEN FOR OUTPUT COCLOSB»0]| CLOSE OUTPUT SIDE OF FILE C0CL0SB«-1] 

iNITiALIZE lOS 

STORE UUO Bits 

ATTEMPT AN ENTER WITH SERVICE ROUTINE 

iF ENTER FAILS, EXIT 

FLAG FILE OPEN FOR OUTPUT CENTRB*liOCLOS8*0J 

STORE UUO BITS 

EXIT 

LOOKUP (ilUO LEVEL - UUOCON) 

PREPiRE to SUPPRESS OUTPUT CLOSE 

IF F!LE open FOR INPUT CICLOSB«0]| CLOSE INPUT SIDE OF FtLE CICLOSB*!] 

iNITiALIZE lOS 

STORE UUO Bits 

ATTEMPT A LOOKUP MITH SERVICE ROUTINE 

IF LOOKUP FAILS, EXIT 

FLAG FILE OPEN FOR INPUT CLOOKB*!, ICLOSB*0] 

STORE UUO BITS 

EXIT 

tNPUt CLOSE <UUO LEVEL - UUOCON) 



^LAG SUCCESSFUL COMPLETION CLOOKB«>0| iCLOSB^ll 
EXIT 

OUtPilT CLOSE (UUO LEVEL - UUOCON) 



PLAQ SUCfiESSPUU COMPLETION CEnVrB'0.OCLOSB«>1] 
EXIT 

iNIT (UUO LEVEL > UUOCON) 

FLAG SUCCESSPUU COMPLETION CtNITB*!. ICLOSB^'itOCLOSB*!] 
(SET ICt,OSB,OCL0SB PRETENDING AN EARLIER CLOSE TO PREVENT 
SUPERFLUOUS CALLS TO CLOSE AT LOOKUP, ENtER tlME> 



5. FILSER FLOW 
FLOW FOR LOOKUP 

IF ZERO FILE NAME, ERROR RETURN 

iF AN ENTER IN FORCE ON THIS USER CHANNELi ERROR RETURN 

SETUP FILE STRUCTURE SEARCH SPECIFICATION FROM INIT PHYSICAL NAMECCALL SETSRC3 
SEARCH CORE AND DISKS FOR FILE NAME, SETUP CORE BLOCKS IF FOUNDtCALL FNOFIU]^ 
IF ANY ERROR EXCEPT FILE NOT FOUND, ERROR RETURN TO USERllFNDFIL DID NOT CREAtE ACCESS BLOCK) 
iF FOUND, TO FOUND 

IF DEVICE NAME WAS DSK WITHOUT A PROJ-PROC SPECIFIED 
IF THIS JOB WANTS PROJECT LIBRARY SEARCHED 

SEARCH PROJECT LIBRARY IN CORE AND DISK USING SYSTEM SEARCH LiSTCCALL FNDF1L3 

iF FILE FOUND, TO FOUND 

END 

IF THIS JOB WANTS SYSTEM LlBRARY(l,3J SEARCHED 

SEARCH SYSTEM LIBRARY IN CORE AND DSIK USING SPECIAL SYS LISTESYSSRCUCALLrNOFJLJ 
IF FILE FOUND, TO FOUND 
END 
END 
ERROR RETURN TO USER (FNOFIL DID NOT CREATE ACCESS BLOCK) 

FOUNDI SET DEVICE DATA BLOCKCOEVRSU,DEVFLT,OEVBLKiOEVREL»DEVReT,DEVFLR3 

SET FILE STATE TO READCDEVSTS] 

COPY VALUES USER HANtS FROM ACCESS, NAME, UFD, AND PROJ-PROG BLOiSKS tO U«ER 

IF USER WANTS MORE VALUES THAN IN CORE BLOCKS 

IF RIB IS NOT ALREADY IN A MONiTOR BUFFER, READ RIB INTO MONITOR BUFFER 
SET DEVICE DATA BLOCK[DEVR9U,OEVFLt,DEVBLKiDEVRCL,QEVRET.OEVRLC,DEVFLR3 

SET ACCESS BLOCK DATACAClPTl, ACIALC, ACCWRTi ACIDTE, ACtPRT9 
COPY ALL ARGUMENTS USER WANTS FROM MONITOR BUFFER TO USER 

END 

IF A MONITOR BUFFER IS IN USE BY THIS JOB, RELEASE IT TQ SYSTEMClOSMBF] 

OK RETURN TO USER 



FLOW FOR ENTER 

IF ZERO FILE NAHC. ERROR RETURN 

IF LOOKUP IN FORCE ON THIS USER CHANNEL) TO UPDATE 
SETUP SEARCH SPECIFICATION ACCORDING TO INIT NAMECCaLL SETSRC] 
SEAReH CORE AND DISK FOR FILE NAMECCALL FNDFILJ 

(IF FILE FOUND BY FNDFIL PROJ-PROG,UFD,NAME, AND ACCESS BLOCKS SETUP) 

!F ERROR OTHER THAN FILE NOT FOUND, ERROR RETURN TO USER(FNOFIL DID NOT CREATE BLOCK ACCESS) 
!F FfLE NOT FOUND. TO CREATE 
SUPSEDI SET STATE FILE TO SUPERCEDECDEVSTS](ACCESS TABLE ALREADY SET TO SUPERCEDE BY FIDFIL) 
IF THIS PR0J-PR06 IN THIS STR IS OUT OF SPACECUFBTAlJ.TO STRLOP 
to UNILOP 

CREAtEl SET STATE OF FILE TO CREATEC0EVSTS3<ACCESS TABLE ALREADY. SET TO CREATE BY FNDFIU) 
STRLOPI iF ONLY ONE STR iN SEARCH SPECIFICATION 

IF THAT STR HAS NO ROOMCSTRTAL^.ERROR RETURN TO USER 

TO USESTR 
END 
STiLOPi 00 FNOSTR. FOR EACH FILE STRUCTURE IN SEARCH SPECIFICATION 

tP THIS PROJ-PROG IN THIS STR HAS NO MORE ROOHCUFBTALJ. TO FNDSTR 

ir THIS JOB DOES NOT WANT CREATES IN THIS STRCJBTUFBJ , TO FNDSTR 

TO USESTR 
FNOStRI CONTINUE^ 

ERROR REtURN TO USER(NO ROOM IN ANY STR) 

USEStRl SET ACCESS BLOCK LOCATIONS TO THIS STR NUHBERCACCFSNl 

If oevlcE name specifies a particular unit cdevnam] 

IP THAt unit has SOHE SPACECUNITAL3>T0 USEUNI 

gNO 
ilNiLOPi 00 PNOUNti FOR ALL UNITS IN THIS STRCSTRUNI-UNISTR3 

IP THIS UNIT 18 THE MOST EMPTY SO FARCUNITAL3, REMEMBER IT 
FNDUNII eONtlNUC 
USEUNXI lET fjR$t-POlNTER-lN-FILE UNIT WITH STR IN ACCESS BLOCK tACCUNI] 

iCT pIMt RETRElVAL JOINTER IN DEVICE DATA BtOCK TO THIS UNIT NUMBERtOEVPTI ,DEVUNI3 

IP UlEft SPCCiPYING ALLOCATION. TRY TO ALLOCATE N OR LESS BLOCKS 

fP CiNAOt 6Ef E)(ACTlY N, REMEMBER ERROR 

•EARSh POR KONGRP OR LESS BLOCKS ON tH|S UN|T 

iP^Otb^NPT PiMD ANV, SPACE IN ANY UNIT IN STR TO STRLOP 

SET SE&OND POINTER IN DEVICE DATA BLOCK TO POINT TO THIS SPACEC0EVPT23 

OUEUfe fW MONITOR BUFFER 

BOPY UfER AROS INTO MONITOR BUFFER 

eOPy THE FIRST UNIT AND FIRST RETRElVAL POINTER INTO MONITOR BUFFER 

HRttE tlHsr RIB 

POPY A| MANY VALUES PROM MONITOR BUFFER AS USER WISHES 

BIVE UP MONITOR BUFFER 

|P ALLOCATION FAILURE. ERROR RETURN TO USER 

OK HETURlil TO USER 



UPDATEi |F FILE NAMES DO NOT MATCHCOEVFlLiEXT,PPBNAM"USER ARC], ERROR RETURN 

• (DO NOT CHECK IF THIS STR IS WRITE LOCKED FOR THIS gSERtDEPHLK3 

SINCE HE MAT JUST WANT TO READ AND LOCK OUT OTHER WRITERS) 
CHECK PRIVILEGES TO AT LEAST APPEND (UPDATE HIGHERJCCALL CHKPRV3 
IF CANNOt APPEND, ERROR RETURN TO USER 
IF USER CHANGING ALLOCATION 

• IF THIS FILE STRUCTURE IS WRITE LOCKED FOR THIS USERi ERROR REtURN 
IF ALLOCATING EACIALCJ 

CHECK PRIVILEGES TO ALLOCATECCALL CHKPRVJ 
OR IF DEALLOCATING CAClALCi ACCWRT] 

CHECK PRIVILEGE TO DEALLOCATE, CCALL CHKPRV3 
ELSE (MUST BE TRUNCATING, I.E., THROWING AWAY DATA BLOCKS) 

CHECK PRIVILEGES TO TRUNCATE CCALL CHKPRV3 
END 
IF CANNOT DO OPERATION, ERROR RETURN TO USER 

• NOSCHEDULE 

• SEf^FILE'fo*BElNG\pDATED"''°"" tACPUPD3 OR RENAMED CACPREN3, SCHEDULE AND ERROR «TU(«N 

• SCHEDULE 

IF ALLOCATING 

SEARCH FOR K-N OR LESS BLOCKS ANYWHERE IN STR OR AT A PARTICULAR LOGICAL iLOflK 

IF NOT FIND ALL K-N BLOCKS, REMEMBER ERROR •."ojvou -l-gDU 

IF COULD NOT FIND ANY BLOCKS, ERROR RETURN tO USER 

ADD ONE POINTER TO DEVICE DATA BLOCK 

IF RUN OUT OF ROOM IN DEVICE DATA BLOCK tDEVRETiQEVRBN(F) 3 

READ RtB INTO MONITOR BUFFER 

APPEND CORE POINTERS TO POINTERS IN RI8 

IF RUN OUT OF ROOM IN RIB CDEVRSU3, ERROR RETURN TO USER {tEMPORAR* IN LCVtL D) 

WRITE MONITOR BUFFER BACK ONTO FIRST RiB ONLY(SECQND RtB OS CLOSE) °' 

GIVE UP MONITOR BUFFER 
END 
OR IF DEALLOCATING OR TRUNCATING 

00 A USETI TO POSITION THE FiLE AT PLACE TO START RETURNING SPACE 

READ THE RIB INTO MONITOR BUFFER 

MARK THE FILE IN CORE AS SHORTER [ACCWRT ACIALC] 

MARK. THE RIB AS NEW SHORTER EOF IN DEVICE DATA BLOCK AND MONITOR BUFfER 

REWRITE The monitor buffer onto rib on disk (SECOND RIB ON CLOSEJ 

DO DELGRP, FOR ALL GROUPS BElNC DELETED INCLUDlN? PART OF CURRENT ONE 

RETURNS SPACE tN CORE BY CLEARING CLUSTER BITS 
_ WRITE SAT BLOCKS ON DISK ONLY IF NEEDED IN ORDER TO READ OtHERB IN 

GIVE UP MONITOR BUFFER 
END 

• ELSE (USER NOT CHANGING ALLOCATION) 

• NOSCHEDULE 

• SEf''FiLE'TO*BE!NG^UPDiTED""*"°'^"''"''""' "" "^*^" "" "^NAMED, SCHEDULE AND ERROR RETURN 

• SCHEDULE 
END 

OK RETURN 



ARGUMENTS TQ FNDFIL 

i, SEARCH SPECinCATION (LIST OF STR TO BE SEARCHED IN ORDER) 

e, JOB NUMBER (TO GET SOFTWARE WRITE-LOCK 

C, FILE NAME 

0, EXTENSION 

E, PROJECT-PROGRAM NUMBER 

F, LOOKUP. ENTER. CHANGE NAME 

G, ADDRESS OF DEVICE DATA BLOCK 

VALUES FROM FMDFiL 

A, OK RETURN (CORE BLOCKS CREATED AND INITIALIZED} 
!F FOUND (LOOKUP AND ENTER) 

NOT FOUNO(ENTER. CHANGE NAME) 

B, ERROR RETURN (CORE BLOCKS NOT NECESSARILY SET UP, CALLER DOES NOT HAVE TO DELETE) 
i. CAN'T FIND FILE (ON LOOKUP) 

2. USER CAN'T CREATE IN THIS UFO (ENTER) 

3, USER CAN'T READ. UPDATE, SUPERSEDE THIS FILE BECAUSE OF ITS STATE 

4. PRIVILEGES DO NOT ALLOW LOOKUP/ ENTER, CHANGE NAME 

5, FOUND FILE ON CHANCE NAME 

C, SETS UP CORE BLOCKS IF OK RETURN 

i, PROJECT PROGRAMMER NUMBER WITHIN SYSTEM BLOCKCPPB] 
2, USER PILE DIRECTORY WITH FILE STRUCTURE BLOCKCNMB] 

4, ACCESS BLOCK WITHIN NAME WITHIN PROJ PROG WITHIN SYSTEM BLOCK CACC3 

5, SECOND HALF OF ACCESS SLOCK CAK6] 

gPERATlON OF FNOFIL 

A. FNOPIL tS ONLY CREATOR AND DELETER OF 

CORE BLOCKS (ACCESS« NAME, PROJoPROG, UFD BLOCKS) 

B. SO ^NOFIL DOES NOT CREATE CORE BLOCKS FOR LOOKUP NOT FOUND 
e, BilT DOES FOR ENTER NOT FOUND 

6, riioPiL ALSO checks privileges and deletes core blocks if 

tf WISHED ON ERROR DEVACC-0 IS FLAG THAT ACCESS BLOCK 
IS 6ELETC0 ON ERROR 

C. FNOl'lL SETS StATE OF ACCESS BLOCK ON INCREASES READ COUNT, tit SO 
P, FNOFIL INITIALIZES ALL LOCATIONS IN ANY CORE BLOCKS |T CREATES, 
6, FNOFIL RETURNS ERROR COOES ON ALL ERROR RETURNSI THESE ARE PASSED 

B^CK to USER 
H, FNDPIL LEAVES RIB IN MONITOR BUFFER ONLY IF IT HAD TO READ IT CIOSMBF SET] 



FLOW FOR FNOFIL CALLED BY LOOKUP, SEARCHt ENTER, RENAME 



AN ACCESS BLOCK CAN BE IN EXACTLY ONE OF THE FOLLOHING 
STATES WHEN EMCOUNTERED BY FNDFILI 

BECAUSE OF THE RESTRICTIONS ON ENTER, MOST OF THE TIME THERE CAN BE 
AT MOST ONE ACCESS BLOCK WITH A GIVEN FILE NAME 
(AND FILE STRUCTURE, PROJ.PROC AND EXTENSION), THE EXCEPTIONS 
ARE THAT R AND S MAY OCCUR SIMULTANEOUSLY IN TWO 
DIFFERENT ACCESS BLOCKS, ALSO AN ARBITRARY NUMBER OP EXTRA 
ENTRIES MAY BE MARKED FOR DELETION (K) 

BECAUSE THEY HAVE BEEN SUPERCEDED, BUT SOME SLOW READERS ARE STILL 
READING OLDER VERSIONS, THESE ACCESS BLOCKS HOWEVER ARE NOT SEEN BY PNDFlL 
SINCE THEY ARE REMOVED FROM THE RING OF ACCESS BLOCKS FQR THE NAME BLOCK 
WHEN THEY ARE HARKED FOR DELETION, FINALLY IF THE PROjECt«PROGRAMMER 
NUMBER HAS 1<iOHt THAN ONE FILE BY THE SAME NAME IN DIFFERENT 
FILE STRUCTURES, THERE WILL BE A SEPARATE ACCESS BLOCK FOR EACH 



AN ACCESS ENTRY 



NtNON EXiSTANT FILE 
O-DORMANT 



R«l OR MORE READER5(MAYBE ANOTHER S) 



CwBElNG CREAtEO 

S.SUPERSEDING (MAYBE ANOTHER R) 

UR'BEING UPDATED AND READ 

K-MARKED FOR OELETIONdE SUPERSEDED) 



LOOKUP 




ENTER 


Aenahe 


SEARCH 




(CREATE, 


iSEARCH rOR 






SUPERCEDE) 


NEM NAME IP OtrP,> 


ERROR 




CREATE 


OK 


USE 




USE 

REMEMBER 

KEEP L00KIN6(S) 


ERROR 


USE 




iERROR 


REMEMBER 


FOR 






POSSIBLE 


ERROR 






KEEP LOAOtNG 


tnnon 


iERROR 


KEEP LO0KIN6<R) 


CRNQR 


fRROR 


USE 




CR"OI* 


ERROR 



(NOT SEEN BY FNO^IU) 



IN ORDER TO SAVE DISK SEEKS, FNOFIL REMEMBERS 
RECENT FILE NAMES ALONG WITH THE PROJECT PROGRAMMER NUMBERS 
AND PILE STRUCTURES iN WHICH THEY WERE FOUND, 

fHtS ASSOCIATIVE CORE INFORMATION HAS A RATHER COMPLEX 
STRUCTURE IN ORDER TO SPEED UP SEARCHES THROUGH IT, 
THE LISTS ARE AS FOLLOWSl 

tHE SYSTEM HAS A LIST OF RECENTLY ACCESSED PR0JE(JT-PRO(!RANMER 

NUMBERS tSYSPPB-PPBSYS3. 

EACH PROJECT PROGRAMMER NUMBER BLOCK CPPB3 HAS TWO LiSTSi 

A, A UFD BLOCK tUrB3 FOR EVERY FILE STRUCTURE IN WHICH THE PROJECT- 
PROGRAMMER NUMBER HAS A UFD CPPBUFB-UFBPPB] 

B, AND A NAME BLOCK CNMEJ FOR EVERY NAME WITH THIS 

PROJECT PROGRAMMER NUMBER (INDEPENDENT OF PILE STRUCTURE>C^PBNME-NMEPPB3 
EACH. NAME BLOCK HAS AN ACCESS BL0CKCACC3, LIST WITH AN ENTRY 
FOR EVERY ACTIVE FILE WITH THAT PROJECT PROGRAMMER NUMBER 
AND NAME, [NHBACC-ACCNMB3 



iN 0?DER TO ELIMINATE FRUITLESS SEARCHES, 

THE PROJECT PROGRAMMER NUMBER BLOCK HAS A BIT FOR EACH 

OF THE gP TO 14 ON-LINE FILE STRUCTURES WHICH 

SAY WHITHER UFD EXISTS FOR THE PROJECT-PROGRAMMER NUMBER 

OR NOT OR WHETHER WE DON'T KNOW YET, SIMILARLY THE 

NAME BLOCK CNNB] HAS A BIT FOR EACH OF UP TO 14 

ON-LiNE FILE STRUCTURES WHICH SAY WHETHER FILE EXISTS 

FOR THE PROJECT PROGRAMMER NUMBER OR NOT OR WHETHER WE DON'T 

KNOW YET'. 



FLOW FOR FNDFIL ABBREVIATED VERSION 



FNDFILI 
FNDFUII 



SCNACCI 

CFPCHKI 
UFBLUPI 

CREUFBI 
SCNUFOl 

SCNStRl 



IF PROJ-PROO BLOCK NOT IN CORE TOR SYSTEM, CREATE ONE AND APPEND TO LIST FOR SYStEHtPPB: 
n 2fIII.5'-2£!i I!°* 'K £1"! ^°'^ PROJ-PRoC, create one and append Tp list for PR0O«#R0CtNMBJ 
DO SCNSTR FOR EACH STRUCTURE IN ORDER OF SEARCH LIST SPECIFICATIONS Mi.t"no3 

IF EXISTENCE OF FILE IN THIS STRUCTURE IS DEFINITELY NO, TO SCNSTR 
IF EXISTENCE OF FILE IN THIS STRUCTURE IS UNKNOMN, TO CFPCHK 

DO SCNACC FOR ALL ACCESS BLOCKS IN RINS FOR THIS NAHE BLOCK (INOEPCNOENT OP STRUCTURE) 
IF ACCESS BLOCK NOT FOR THIS STRUCTURE, TO SCNACC rtnutni ur ainufcTuntj 

IF LOOKUP (INCLUDING EXECUTE) 

IF DORMANT OR BEING READ AND/OR UPDATED 

IF ACCESS PRIVILEGES DO NOT ALLOM DESIRED ACTION, ERROR RETURN 

INCREMENT READ COUNT 

IF DORMANT, REMOVE FROM DORMANT LIST 

OK RETURN 

or'?? ^5?E%\gffio?V''S??jT^?§S ?^if U«pt'" """ ''" ''' ""' '" '''" "''^""«» 
IF BEING CREATED, SUPERSEDING OR BEING UPDATEDi ERROR RETURN 
r iS£E!S»'*''in''ES^! °5 NOT ALLOW SUPERSEDE, ERROR RETURN 
IF DORMANT, SET STATE TO SUPERSEDING, REMOVE FROM DORMANT LjST, ANO OK REtURN 

ELsHSS" Se'chJS"" NA«I " *"' "^ " "*'"^" "" °^'-'"°*' " ^""""iNS CUOSEirtLE iCiNb dClO) 
^^ERROR RETURN (SINCE ONLY EXISTING NAMES MARKED FOR DELETION ARE UE8AL AND tHOSE fiANNOt BE ^0UN6) 

CONTiNUE 

(MIGHT HAVE FOUND ACCESS BLOCK CREATING OR SUPERSEDING ON LOOKUP, OR READING ON CNtERl 
F COMPRESSED POINTER TO RETRIEVAL BLOCK IN THIS NAHE BLOCK fXthIS STRUCtURE, tO "lMB 
IF CAN FIND A UFB BLOCK FOR THfS STRUCTURE, TO SCNUfO aT«uBTU«, to fiLRRB 

IF UFD NAME NOT FOUND IN SEARCH OF MFD FILE, TO SCNSTR 

i^v°iL"E%ssr?§sfife ?"i^;Rg!'SF'^F"5^?t??^o*''?IL*!;ss'"' '° ■"'" '" '"*» -"•'-"'"'< "^ one cb Not sneax w 

MARK FILE NAME AS DEFINITELY NOT IN THIS STRUCTURE 
CONTINUE 
{FILE NOT FOUND OR FOUND READING ON ENTER) 

!r i;fl2'*i!!i 1*,5''.*'*'*^ ^'■°" *' "abbable and error return 

IF ONE DID SNEAK IN, BACK TO FNOFLKREPEAT FNQFU OPERATION) 
IF CHANGING NAME OB DIRECTORY FUNCTION (RENAME UUO) 

ir.USER NOT PRIVILEGED TO DO THESE, ERROR RETURN 

CHANGE NAHE AND DIRECTORY IN ACCESS BLOCK 

OK RETURN 
END 

?r«E^tgus*''s§lE^^B^=gcK*''5Ar5E=gS(R^^S!!J?ss^J?ll,r3^T"^?s?^'?b^^g{ifgi^ 

S^T-^glA^r^Sfer?? JgES?l*;So^51l%^?u^S°' *" *""'"^'""' " aoJSANrKI?''JNS''?RSSR"5^^52N 



{FILE EXJSTS BUT ACCESS BLOCK NOT IN CORE) 
FILRRBI IF CHANCING NAME. ERROR RETURN (NEW NAME ALREADY EXISTS) 

READ FILE RETRIEVAL 8L0CK, CREATE ACCESS BLOCK AND APPEND TO RING FOR THIS NAME<IF ONE DlD NOT SNEAK IN) 

iF ONE Dl SNEAK IN. BACK TO FNOFLltREPEAT FNOFlL OPERATION) 

MARK FILE NAME AS DEFINITELY IN THIS STRUCTURE 

IF PRIVILEGES DO NOT ALLOW INTENDED ACTION(MUST BE EXECUTE, READ OR SUPERSEDE) 

FLUSH ACCESS BLOCK AND ERROR RETURN 
END 

IF LOOKUPIREAD EXECUTE) INCREMENT READ COUNT AND OK RETURN 
SET STATE TO SUPERSEDING AND OK RETURN 



DETAILED FNDFIL FLOW 

FNDFILI QUEUE FOR CB RESOURCE 

PPBLOPI DO SCNPPB, FOR ALL PROJ-PROG BUOCKSCPPB: IN SYSTEMCSVSPPB-PPBSYS] 

IF FIND MATCHING PROJ-PROG NUMBER, TO NMBLUP 
SCNPPBI CONTJNUE 
FNOPPBI CREATE PROJ-PROG BLOCK 

STORE PROJECT PROGRAMMER NUMBER tPPBNAM] 

MARK PPB AS NOT LOGGED IN CPPBNLG3 

MARK THAT PROJ-PROG MAYBE IN EACH STR IN SYSTEMCPPSKNO«03 

MARK THAT PROJ-PROG DOES NOT APPEAR IN ANY StR(EVEN THROUGH IT MAY)EPPBYES»B3 

MARK THAT NO NAME OR UFO BLOCK LISTS CPPBUFB.PPBNMB.PJ 

APPEND PROJECT PROGRAMMER NUMBER BLOCK TO END OF PROJ-PROG LIST fOR SYSTEM CfPBSVSJ 

NMBLUPI DO SCNNMB, FOR ALL FILE NAMES IN CORE IN THIS PROJ-PROG (NO MATTER HHAT STR) CPPBNHB.NMBPl»B] 
IF FILE NAMES AND EXTENSION MATCH, TO STRLOP 

SCNNMBI CONTINUE 

CRENMBI CREATE A FILE NAME BLOCK CNMB3 AND ADD TO END OF THIS PROJ-PROG LIST CPPBNMB3 
MARK IN FILE NAME BLOCK IS NOT GRABBABLE BY FNOFILCNMPGRBoB] 

MARK THAT FILE NAME IS DEFINITELY NOT IN ANY STR IN WHICH PROG-PROG'S IS OCflNlttLY NOt 
MARK THAT FILE NAME MAYBE IN EACH STR IN SYSTEM IN WHICH PROJ-PROG OferiNlTELY YES 
MARK THAT FILE NAME DOES NOT APPEAR jN ANY StR(EVEN THROUGH IT MiV>CNMBYES«B] 
APPEND NAME BLOCK TO END OF NAME LIST FOR THIS PROJ PROC CNHBPPB] 



STRLUPi 00 SCNSTR, FOR EACH STR IN SEARCH SPEClFjCATION IN ORDER CSTRTAB] 

IF EXISTENCE OF FIUE IN THIS STR IS OEFINITLEY NO CNM8KN0,NMBYESC , TO SCNSTR 
IF EXISTENCE OF FILE IN THIS STR IS MAYBE, TO CFPCHKCCAN'T BE AN ACCESS BLOCK) 
QUEUE FOR CORE BLOCK RESOURCE 

00 SCNACC,FOR ALL ACCESS BLOCKS IN THIS NAME/PROJ-PROG LIST (INDEP OF STR> 
IF THIS ACCESS ENTRY IS NOT FOR THIS STR, TO SCNACC 
iF LOOKUP (INCL EXECUTE) 

IF DORMANT OR BEING READ ANO/OR UPDATED 

IF ACCESS PRIVILEGES. DO NOT ALLOW DESIRED ACTION, RELEASE CB RESOURCE, ERROR RETURN 
INCREMENT READ COUNT 

IF DORMANT, REMOVE FROM DORMANT LIST AND MARK NAME BLOCK AS NOT GRABBABLECNMBGRB3 
RELEASE CB RESOURCE AND OK RETURN 
END 

(KEEP LOOKING IF ACCESS BLOCK WAS SUPERSEDING OR BEING CREATED) 
OR IF ENTER (CANNOT BE UPDATE FOR THEN USER) 

IF BEING CREATED, SUPERSEDING, OR BEING UPDATED, RELEASE CB RESOURCE AND ERR RET 

IF ACCESS PRIVILEGES 00 NOT ALLOW THIS FILE TO BE SUPERSEDED, RELEASE CB AND ERR RET 

IF DORMANT 

REMOVE ACCESS BLOCK FROM SYSTEM DORMANT LIST CACCDORJ 
ZERO DORMANT LIST POINTERS AS FLAG EACCOQR] 
SET STATE TO SUPERSEDING 
RELEASE SCAN LIST RESOURCE CC8RE0] 
OK RETURN 
END 

REMEMBER THIS STR SO FILE CAN BE MARKED FOR DELETION ON SUPERSEDING CLOSE CDEVFSN] 
(fiLE ALREADY BEING READ, KEEP SCANNING STRS IN CASE A LATER CREATE, SUPERSEDING, UPOAtE) 
ELSE (MUST BE CHANGING NAME) 

RELEASE SCAN LIST RESOURCE CCBREO] 

ERROR RETURN (SINCE ILLEGAL TO CHANGE A NAME TO AN EXISTING FILE, UNLESS MARKED FOR DELETION) 
END 



SCNACCI CONTINUE 
CFPCHKi 



(COULD HAVE FOUND CREATING OR SUPERSEDING ON LOOKUP, READING ON ENTER) 

IF STR NUHBER tN NAME BLOCK IS NOT THIS STR CNMBFSN], TO UFBLOP 

GEt COMPRESSED VFD POINTER TO FILE RIB CNMBCFP3 

RELEASE CB RESOURCE 

TO FtLRRB (SAVED A SEARCH OF UFO SINCE KNOW WHERE FILE RIB IS} 



UPBLOPt 00 SCNUrB, FOR EACH UFB BLOCK WITH THIS PR0J*PR0GCPPBUFB-UF6PPB3 

ir riNO UFO block with this STR number CUFBFSNJ, to SCNUFD (SAVED MFD SEARCH) 
SCNU^Bt CONTINUE 



REUEASE CORE BLOCK RESOURCE 
QUEUE FOR MONITOR BUFTER 

IF DIRECTORY NAME (PROJ-PROG) IS REALLY MFDUiDi TO UFDLOP 
MFOLOPI DO REDMFC, FOR EACH U DISK BLOCK IN MFD IN THIS STR CSTRPT13 

READ MFD DISK BLOCK INTO MONITOR BUFFER 

SCAN MFD BLOCK FOR UFD NAME 

IF UFD NAME FOUND IN MFD BLOCK. TO UFDRIB 

IF RUNOUT OF MFD RETRIEVAL POINTERS, READ MFORIB INTO SAME MONITOR BUFFER 
REDMFOI CONTINUE 

RELEASE MONITOR BUFFER 

MARK IN PROJ-PROG BLOCK THAT UFD DOES NOT EXIST IN THIS STR tP?BRN0,PPBYE33 
MARK IN FILE NAME BLOCK THAT THIS FILE NAME DOES NOT EXIST IN THIS STR 
TO SCNSTR 

UFDRIBI REikD UFD R18 INTO MONITOR BUFFER 

IF ERROR MHILE READING RiBt ERROR RETURN 

• COMPARE FILE NAME, EXT, AND PROJECT PROGRAMMER NO, STORED iN RiB 

• IF DOES NOT AGREE WITH EXPECTED. ERROR RETURN 



QUEUE FOR CB RESOURCE 

IF A UFB BLOCK SNUCK IN FOR THIS PROJ-PROG. TO STRLUP (REPEAT rNOrlL) 

CREATE A UFB BLOCK FOR THIS FILE STRUCTURE AND APPEND TO LIST tOn PR06-PR06 

MARK FILE STRUCTURE NUMBER IN UFB BLOCK CUFBFSN: 

STORE FIRST UNIT NUMBER WITHIN STR OF UFD CUFBUNl».C(C(RIBFtR) >3 

STORE FIRST RETRIEVAL POINTER TO UFD IN UFB BLOCK f UFBPT1,UFBI?T3 

STORE NUMBER OF FREE BLOCKS LEFT IN QUOTA FOR THIS UFO CUFBTALJ 

STORE NUMBER OF OVERDRAWN BLOCKS ALLOWED FOR THIS UFO CUFBOVR] 

STORE ACCESS PRIVILEGES FOR UFO CUFBPRV3 

MARK IN PROJ-PROG DATA BLOCK THAT tHIS UFD EXISTS IN THIS STR 



SCNUFOi IF THIS JOB DOES NOT ALREADY LEAVE A MONITOR BUFFERCMNBFPT3. QUEUE FOR ONE 

RELEASE CB RESOURCE 
UFOLOPI 00 REDUFD FOR ALL DISK BLOCKS IN UFO IN THIS STRCUFBPTl] 
READ UFO DISK BLOCK INTO HONITOR BUFFER 
SCAN UFO SLOCK LOOKING FOR FILE NAME AND EXTENSION 
IF FtLE NAME FOUND IN UFO BLOCK, TO FILRIB 

iF RUN OUT OF UFO RETRIEVAL POINTERS, READ UFD RIB INTO MONITOR BUFFER 
REDUFDt CONTINUE 

RELEASE MONITOR BUFFER 
OUEUE FOR CB RESORNCE CCBREQ3 

MARK FtLE AS DEFINITELY NOT IN THIS STRCNMBKNOiNMBYES] 
SCNStRI CONTINUE 

iFILE NOt FOUNOi OR FOUND READING ON ENTER) 

IF NO UFOS rOUND FOR THIS SEARCH LIST, ERROR RETURN (UFq DOES NOT EKIST) 

IF LOOKUP (OR EXECUTE) 

IF NAME BLOCK HAS NO ACCESS BLOCKS. MARK NAME BLOCK AS GRABBABLE 

RELEASE CB RESOURCE, ERROR RETURN 
END 

fF AN ACCESS BLOCK HAS SNUCK !Ni BACK TO STRLUP (REPEAT FNDFIL) 
!f changing NAME OR DIRECTORY FUNCTION (RENAME UUO) 

• IF Flue IS ALREADY BE|NG RENAMED CACPREN IN ACYSTS], ERROR RETURN 

IF FtLE IS ALREADY BEING CREATED, SUPRESSINGi OR UPDATED BY SOME USER CHANNEL 

If not THIS USER CHANNEL CENtRB], ERROR RETURN 
IF OLD FILE NAME CNHBNAHCACCNNB(RING}] IS DIFFERENT FROM NEW NAME CDEVFIL] 

!F THIS USER CANNOT CHANGE NAMED CFNCCNHJ, ERROR RETURN CCALL CHKPRVI 
END 
IF OLD DIRECTORY CPPBNAMCACCPPB33 IS DIFFERENT FROM NEW DIRECTORY tFNOFIL AC ARC] 

If THIS USER CANNOT CREATE IN THIS DIRECTORY CFNCCRTJ, ERROR RETURN CCALL CHKPRV3 

!F THIS CHANNEL IS NOT AN UPDATER CENTRBl, ERROR RETURN 

iF NCH DIRECTORY DOES NOT HAVE ENOUGH FREE BLOCKS CUFBTALl TO TAKE A FILE CACCALC], ERROR RETURN 

InCRCNENT OLD DIRECTORY FREE BLOCK COUNT CUFBTAU3 BY ALLOCATED SIZE OF FtLE CAKBALC3 

DECRCHENt NEH DIRECTORY FREE BLO6K COUNT CUFBTAL3 BY ALLOCATED SIZE OF FILE CAKBALC] 
EN6 

SET POiNTCR CACCPPB3 IN OLD ACCESS BLOCK CDEVACCl TO POINT TO tHIS PROJ PROG BLOCK (IN CASE CHANGING DIR',) 
UNLINK OLD ACCESS BLOCK CDEVACC] FROM NAME RIN6CACCNMB9 
FLie OLD NAME BLOCK AS GRABBABLE CNMBGRB3 

FLAG OtD FtlE NAME AS DEFINITELY NOT PRESENT IN THIS STR ENUMKNO«l,NMBYESi0] 
LINK OLD ACCESS BLiBCK CACCNHB3 TO NEH NAME RING COEVFILKIN CASE CHANCING NAME) 
FLAG NCH NiNE BLOCk AS NOT GRABBABLE (tN CASE {T HAS) 

FLlG NCH FtUC NAME AS DEFINITELY PRESENT IN SAME STR CNMBKN0'l,NMBYES>i3 
FLAG THIS FILE AS tN PROCESS OF BEfNG RENAMED CACPREN OREO INTO ACVSTS] 

(FiLC MAY ON NAY NOT ALREADY BEING CREATED CACFCREJ, SUPERSEDING CACPSUPli OR BEING UPtJATED CACPUPD] CACYStS]) 
IBV This USER CHANNEL " BuT NEVER BY ANY OTHER USER PNANNEL) 
RELEASE CORE BLOCK RESOURCE CCBRE03 AND OK RETURN 
CNO 

• If an ACCESS BLOCK HAS SNUCR IN AND tS CREATE, SUPERSEDING, OR UPDATE, OR RENAME, ERROR RETURN 
SRCATE AN ACCESS BLOCK ANO APPEND TO RING FOR THIS NAME BLOCK 

IF FbUNO AN ACCESS BLOCK BEING READ ON ENTER, SET STATE TO SUPERSEOEi RELEASE CB, OK RETURN 



_ (ACCESS PRIVILEGES AtREADY CHECKED INSIOE UOOP SINCE ACCESS BLOCK HAS FOUND) 
IF USER NOT PRIVfLEGED TD CREATE FILES IN UFO 

FLUSH ACCESS BLOCK AND ADO TO SrSTEM FREE LIST AND CLEAR POINTER TO IT IN DDBC0EVACC3 

RELEASE CB RESOURCE AND ERROR RETURN 
END 
SET STATE OF ACCESS BLOCK TO CREATE, RELEASE CB RESOURCE AND OK (lETURN 



FILRRBI (FlLf EXISTSi BUT ACCESS BLOCK NOT IN CORE. USER DOES NOT HAVE CB RESOURCE) 
JF CHANGING NAME. ERROR RETURN (NEW NAME AtREAOY EXISTS) 
IF DONT ALREADY HAVE MONITOR BUFFERC lOSMBFJ. QUEUE FOR IT 
READ FILE RIB INTO MONITOR SUFFER (LEAVE IT THERE FOR RETURN TO CALLER) 
IF ERROR WHILE READING RIB, RECORD SYSTEM ERROR. RELEASE MB AND ERROR RET. TO USER 
QUEUE FOR CB RESOURCE 

IF AN ACCESS SLOCK SNUCK IN, BACK TO STRLUP (REPEAT FNDFlL) 
CREATE AN ACCESS BLOCK AND APPEND TO RING FQR THIS NAME BLOCK 
MARK THAT THIS FILE DEFINITELY EXISTS IN THIS STRUCTURECNMBKMO.NMBYES] 
MARK FILE STRUCTURE NUMBER IN ACCESS BLOCKCACCFSN] 

COPY FIRST UNIT NUMBER WITHIN STR OF FILE IN ACCESS BlOCKC *C1UN1«-C >C)RIBFIR) ) ] 
COPY FIRST RETRIEVAL POINTER TO FILE IN ACCESS BL0CkCAC1PT1«-C(C(RIBFIR)+1) 1 
COPY NUMBER OF BLOCKS WRITTEN IN ACCESS BL0CKCACCWRT«-R1BSI Z/128] 
COPY NUMBER OF BLOCKS ALLOCATED IN ACCESS BL0CKCAC1ALC«-RIBALC/128+13 
COPY ACCESS PRIVILEGES, MODE, CREATION TIME, CREATION DATEt AC1ATT«-RIBATT] 
COPY ACCESS DATE (DAY) IN ACCESS BL0CKCAC1ACD»RIBdTE3 

STORE FIRST LOGICAL BLOCK WITHIN UNIT TO BE READ OH WRITTENtADD 1 FOR RIB) COEVBLK] 

COPY FIRST BUNCH CPTRLEN] OF RETRIEVAL POINTERS INTO DEVICE DATA BL0CKCDEVRB1-DEVRBN3 

SET CROUP INDEX OF FIRST GROUP POINTER IN CORE TO BtDEVRLCJ 

SEt CORE ADDRESS OF CURRENT POINTER TO CORE ADDRESS OF FIRST P0INTERCDEVRET*DEVRB1(F) ] 

SET RELATIVE BLOCK NUMBER TO READ OR WRITTEN (ADD FOR RIBjCDEVBLK] 

SEt RELATIVE BLOCK NUMBER TO READ OR WRITE ON NEXT UUO TO 1 (SKIP RIB)tDEVREL3 

STORE CORE ADDRESS OF ACCESS BLOCK IN DEVICE DATA BLOCKCDEVACC] 

STORE NUMBER OF BLOCKS LEFT IN FIRST GROUP (SUBTRACT 1 FOR RIB)CDEVLFT] 

SEt UPWARD POINTER TO UFO BLOCK IN DEVICE DATA BLOCKCDEVUFB] 

SEt UPWARD POINTER TO UNIT BLOCK IN DEVICE DATA BLOCKCDEVUNI ] 

IF PRIVILEGES DO NO ALLOW INTENDED ACTION, (MUST BE EXECUTE, READ OR SUPERSEDE) 

FLUSH ACCESS BLOCK, ADO IT TO SYSTEM FREE LIST, AND CLEAR POINTER TO IT IN DDBCDEVACC] 
iF THIS IS ONLY ACCESS BLOCK FOR NAME BLOCK, MARK NAME BLOCK OR GRA8BABLE 
END 
IF LOOKUP (INCL EXECUTE) SET READ TO 1 CACYRDCJ, RELEASE CB RESOURCE, OK RETURN 



-OOKUP i 
SLATE T 



SEt SLATE to SUPERSEDING, RELEASE CB RESOURCE, OK RETURN 



■low for CHKPRV subroutine - CHECK ACCESS PRIVILEGES FOR THIS ySER 

IF MOST POWERFUL OPERATION THIS USER CAN PERFORM ON THIS FILE HAS BEEN STORED. TO CHECKCDEVFNC] 
IF THIS USER IS ALSO THE OWNER OF THE F JlEC JBTPPB.DEVACC( ACCPPB) 3 

IF USER IS TRYING TO "CHANGE PR0TECTI0N"CFNCCPR3, OK RETURN (DO NOT STORE HIGHEST PUNCtlONJ 

GET FILE PROTECTION AGAINST THE 0WNERCAKBPRV3 
OR IF THIS USER IS A MEMBER OF THE OWNER'S PROJECT 

GET FILE PROTECTION AGAINST THE REST OF THE OWNER'S PROJECTCAKBPRVJ 
ELSE 

GET FILE PROTECTION AGAINST ALL PROJECTS EXCEPT THE OWNER'S 
END 
IF THIS FILE IS A DIRECTORY FILE (MFD OR UFDI CAKBDIR»1] 

IF THIS USER JOB IS PRIVILEGED FILE SYSTEM CUSP C J8TST9C JACCT3.t3, OK RETURN (DO NOT STORE FUNCTION) 
IF USER IS TRYING TO DO MORE THAN JUST "READ" DIRECTORY AS A FILE, ERROR RETURN (DO NOt StORE) 
IF THIS USER IS THE OWNER OF THE FILE (UFD.MFD) "lonii 

IF OWNER CANNOT RE*D DIRECTORY AS A FILECUFBARD.B], ERROR RETURN 
OR IF THIS USER IS A MEMBER OF THE PROJECT IN WHICH THE FILE(Uf D,MFD) BELONGS 

IF REST OF OWNER'S PROJECT CANNOT READ DIRECTORY AS A F ILECUfBPRD«03. ERROR RETURN 
ELSE (THIS USER NOT IN OWNER'S PROJECT) "«■ i uni, 

IF UNIVERSE CANNOT READ DIRECTORY AS A FILECUF9URD"03, ERROR RETURN 
END 

?I°nSr!lS^*°'' ""UNCTION AS MOST POWERFUL THAT THIS USER CAN PERFORM ON THIS FILEtUFD.MrOJCOEVFNCJ 
END 

(FILE IS A DATA FILE RATHER THAN A DIRECTORY FILE) 

IF THIS USER IS ALSO THE OWNER OF THE FILE: JBTPPS>! = DEVACC(ACCPPB )3 

GET DIRECTORY PROTECTION AGAINST THE OWNER 

OR IF THIS USER IS A NUMBER OF THE OWNER'S PROJECT 

GET DIRECTORY PROTECTION AGAINST THE OWNER'S PROJECT 
ELSE 

GET DIRECTORY PROTECTION AGAINST ALL PROJECTS EXCEPT THE OWNER'S 
END 

IF DIRECTORY PROTECTION (AGAINST OWNER, PROJECT, UNIVERSE) SAYS tHIS USER CANNOT DO LOOKUP. fO CHKERR 
IF USER IS TRYING TO "CREATE" (RENAME TO NEW DIRECTORY OR ENTER) LOOKUP, TO CHKERR 

To'cHKEr"""^ PROTECTION (OWNER. PROJECT, OR UNIVERSE) SAYS THIS USER CAN "CREATE" IN THIS DIRECTORY, OK RETURN 
END 
TORE, i?SXr;i^i^iT''PSJ^?l^rTiti*iSiR' ?s'5^LDSE"g'?rPEg?0^S''"'^' '° "°" """'^"^ '''"'°' *^'-°"" 

SWr'r ^^(S^JlgSY^^^ASE'fpJSJi^goJ? T'rT. 11 g°AM?°:i S?S^??!ifev^t!iS.»iS?"^Sktg«E"?Er?"' °« "^^"^^ 




END 
END 
ERROR RETURN 



riLE PROTECTION CODESCAKBPTR] FUNCTION CODESCDEVFNO: 



a NO ACCESS PRIVILEGES 

i PRtEXC EXECUTE ONLY 

2 PRTRED READ 

S PRTAPP APPEND 

3 

3 

4 PRtUPO UPDATE 

JNO FILE YET) 

5 PRTWHT WRITE 
S 

« PRtREN RENAME 

« 

6 

7 PRTCPR CHANGE PROTECTION 



z Function not stored yet 

1 fncexc execute only 

2 FNCREO read 

3 fncall allocate 

4 FNCDLL deallocate 

5 FNCAPP APPEND 

6 FNCUPO UPDATE 

7 FNCCRT CREATE 

10 FNCSUP SUPERSEDE 

11 FNCTRN TRUNCATE 

12 FNCCAT CHANGE ATTRIBUTE(EXCEPT PROTECTION NAME) 

13 FNCDEL DELETE FILE 

14 FNCCN^l CHANGE NAME 

15 FNCCPR CHANGE PROTECTION 



FLOH FOR ENTER/RENAME ALLOCATION, 

IF USER is TRUNCATING FILE (N ,LE, K). TO TRUNKT 

IF INCREASED SIZE WILL EXCEED UFO QUOTA CC<UFBTAL)-N NEC, 3 

CHANGE USER ARR N TO NUMBER, FREE BLOCK LEFT CUF8TAL] 

FLAG FOR ERROR RETURN 
END 
IF USER SPECIFIED WHERE TO ALLOCATE 

CONVERT LOGICAL BLOCK NO. WITHiN F',S. TO UNIT+LOOICAL BLOCK NO, WITH IN UNIT 

TRY TO ALLOCATE (N-Kl BLOCKS OR LESS ONLY AT SPECIFIED STARTING PLACE 

ERROR OR OK RETURN TO USER 
END 
IF FILE NOT CURRENTLY ASSIGNED TO ARRAY UNIT CDEVUN1»03 

PICK THE MOST EMPTY UNIT AN ANY FILE STR, ALLOWED BY USER DEVICE NAME 
END 

tRY to ALLOCATE EXACTLY (N-K) BLOCKS NEXT TO END OF FILE ON CURRENT UNIT 
IF CAN'T GET<N-KI, TRY TO ALLOCATE (N-K) OR LESS BLOCKS ANYNHERE ON UNIT 
IF (N-K) FOUNDi OK RETURN TO USER 

REMEMBER WHETHER MAX. FOUND ON CURRENT UNIT MAS GREATER THAN HININUM CKONFRC] 
00 UNILOP. FOR REST OF UNITS SPECIFIED BY USER DEVICE NAME 
tRY to ALLOCATE EXACTLY (N-K) CONSECUTIVE ANYWHERE ON VNlT 
IF FOUNDi TO NEHUNI 
UNlLOPl CONTINUE 

IF MAX FOOUND ON ORIGINAL UNIT WAS GREATER THAN HINIMUMCKONFRGl 

USE SMALLER-THAN-DESIREO HOLE ON ORIGINAL UNIT 
ELSE 

USE LARGEST SMALLEST-THAN-DESIRED HOLE ON BEST UNIT SCANNED 
END 
ERROR RETURN TO USER 

NEWUNII ADD NEW UNIT POINTER TO RETRIEVAL POINTERS BEFORE RETRIEVAL POINtER 
OK RETURN TO USER 

TRUNKTI READ DISK RIB BLOCK 

SCAN RETRIEVAL POINTERS FOR FILE (DO USEI FOR LAST DESIRED BLOCK) 
CHANGE CURRENT RETRIEVAL POINTER AND SET NEXT ONE TO AS EOF FLAG 
REWRITE DISK RIB (BEFORE ANY SPACE RETURNED IN CASE SYSTEM GOES DOWN) 
RETURN REMAINING SPACE OF CURRENT RETRIEVAL POINTER 
SO DELLOPi FOR ALL REMAINING RETRIEVAL POINTERS IN FILE 
IF NEW UNIT, CHANGE UNITS 

DELLOPI RETURN ALL CLUSTERS WHICH THIS POINTER POINTS TO 
RETURN TO USER 



ALLOCATION FLOW FOR OUTPUT 

iF UfO QUOTA HAS BEEN DRAWN BY MORE THAN MAX OVERDRAW, TO ERRFUL 

TRY TO ALLOCATE A NOMINAL CROUP OR LESSCKONGRP] ON UNIT STARTING AT EOF 

IF NO BLOCKS AVAILABLE STARTING AT ENO OF FILE 

TRY TO ALLOCATE A NOMINAL GROUP OR LESSCKQNGRP] ANYWHERE ON THIS UNIT 

"If ^NO*BLOCKr AVAILABLE * ^°""^*'- "°"'' °'' l-ESSCKONGRPa ON ANY USER UNIT ALLOED BY THE NAME 
ERRFULI SET ERROR FLAG FOR USER tI0BKTL3 
ERROR RETURN TO USER 
END 
CNO 
END 
CNO 

ALLOCATION PLOW fOR USETO 

If an ENTER HAS NOT BEEN DONE, TO SUPERS 

IF rlLC INCREASE WOULD USE UP ALL BLOCK IN UFO QUOTA tUFBTAL: 

SET ERROR FLAG CI0BKTL3 

RCtURN TO USER 
|NB ^ 
TRY to ALLOCATE (N-K> OR LESS BLOCKS AT END OF FILE CACCALC3 

If all (n-k) SLOCKS allocated, return 

°°D§'S!:?[0PriN^iL*iN^S^H%J§S^i ^IVcl'il'" '' "'" °^''" '''' "*"'^'= "'^" '''' "^'^ 

trEl§u21i''SL"0CAtE'fe.%"E?fiSJ °' ''"'''*''' °"'"^° ''''' "^ ^"'^ '*"' 
ALCLOPi CONTINUE 

SET iWOR FLAG (lOBKTL) 
RETuHN to USER 

SUPERS I 



I* 



2 ROUTINES FOR ALLOCATION CALLED BY CNTER»RENAHEiUSETOiOOTPUT 

1. tRY TO ALLOCATE EXACTLY M(M.N«K> CONSECUTIVE BLOCKS ON THIS UNIT 

ARCS I 

FILE (FJ 
UNIT (U) 

NUMBER OF CONSECUTIVE BLOCKS WANTED {EXACTLY) 

LOGICAL BLOCK NUHBER TO START WITHIN THIS UNIT <B HEANS ANYHHERE 
GN UNIT WILL 00) 

2. tRY to ALLOCATE M OR LESS (M«N'K> CONSECUTIVE BLOCKS ON THIS UNit 

ARBSI SAME 

IF SUCCESSFUL RETURN. THESE ROUTINES MARK STORAGE IN SAT TABLES 
ANS EXPAND LAST GROUP POINTER OR ADD UNIT AND/OR CROUUP POINTERS', 
ALSO THE COUNT OF FREE BLOCKS IN UFO MILL BE DECREHENTEO 

(POSSIBLY PART ZERO IF OVERDRAW) ONLY AFTER SaT TABLE HAS BEEN 

SUCCESSFULLY MARKED. 
iF ERROR RETURN. NO SPACE MARKED AS IN USE, 

FLOW FOR USEtl.USETO 
IF USETl 

IF USER ARG PAST HIGHEST RELATIVE BLOCK WRITTEN CACCWRT] 
SET EOF 

END RETURN TO USER 
END 

IF DESIRED BLOCK IS BEFORE FIRST IS CORE POINTER C .L.C(OEVFLR) 3 . TO USTRlB 
CALL PTRSCN, (IN-CORE POINTER AREA) 
IF FOUND. TO RANFNO 
USTRIBt READ RIB BLOCK FOR FILE (AS IF INPUT UUO FOR RELATIVE BLOCK ■ OF PILE) 
(HERE WHEN RIB BLOCK IN ONE OF MONITOR CORE BUFFERS) 
CALL PTRSCN, (MONITOR CORE BUFFER) 
!F FOUND 

COPY WINDOW SURROUNDING DESIRED POSITION INTO FILE DOB 

TO RANFND 
END 
IF USETI UUO 

SET EOF 
ELSE (USETO UUO) 

ALLOCATE ENOUGH CROUPS TO FILL OUT FILE 
END 
EXIT 

RANFNOI SET UP FILE DATA BLOCK POINTERS SO NEXT SEEK OR INPUT OR OUTPUT UUO 
WILL ACCESS THIS BLOCK 
EXIT 



iSUBROUTiNE tO SCAN RETRIEVAL POINTERS IN FILE DATA BLOCK OR MONITOR BUFFER 
INTERNAL SUBROUTINE PTRSCN. (CORe LIMITS) 
bo PtRLOP, UNTIL RUN OUT OF POINTERS 
IF CLUSTER COUNT IS 

IF WORD IS HERO <MUST BE EOF) 

NOT-FOUND RETURN 
ELSE (MUST BE CHANGED IN UNIT) 
SETUP FOR NEW UNIT 
TO 
ELSE (MUST BE REAL RETRIEVAL POINTER) 

IF DESIRED POSITION IS IN THIS GROUPi FOUND RETURN 
END 
PTRLOPI CONTINUE 

NOT FOUND RETURN 



V2I04 



UUO CODE FOR SEEK UUO 



Va04 
V0!?4 
V007 
V05I7 

V0PI4 
\IBVIA 

V0f»4 



IF RUN OUT OF CLUSTER POINTERS. READ CLUSTER PTRS 

IF NEXT PTR IN CORE AN EOF. RETURN 

IF KONTROLLER DOESN'T POSITION OR UNIT IS IDLE. EXIT 

INHIBIT SCHEDULING 

TURN ALL DISK PI'S OFF 

IF CHANNEL IS IDLE. TO UUOSEK 

SET STATE OF UNIT TO SW 

(LEAVE STATE OF FILE AS IT IS) 

PUT FILE IN SH/PW QUEUE (ONLY ONE THERE) 

TO SEKRTl 



V0e4 UUOSEKI IF A UNIT IS ALREADY AT DESIRED POSITION. TO SEKRTl 

V0?4 SET STATE OF UNIT TO S 

V0n4 (DO NOT FLAG ACTIVE 10) 

V0(!4 TURN ALL DISK PI'S BACK ON 

V0?7 ENABLE SCHEDULING 

V0E!4 ISSUE POSITIONING COMMAND 



V004 SEKRtll TURN ALL DISK PI'S ON 
V004 SEKRT2I SCHEDULE 
V0d7 EXIT 



ABBREVIATED RENAME FLOW 

iF USER CHANNEL HAS NEVER BEEN CONNECTED TO A FILE BY LOOKUP OR ENTER C0EVFIL=a3, ERROR RETURN 
IF USER CHANNEL HAS BEEN CLOSED, FlNn OLD FILE USING USER'S LOOKUP OR ENTER NAME CDEVFILJ 
IF USER IS TRYING TO DELETE FILE AND HAS THE PRIVILEGES TO DO So 

MARK FILE FOR OELETION WHE'-J READ COUNT GOES TQ 

TO CALCLS 
END 

iF FILE IS MARKED FOR DELETION. ERROR RETURN 

IF USER IS CHANCING FILE NAME, EXTENSION, OR DIRECTORY, ERROR RETURN IF NEW NAME ALREADY EXISTS CCALL FNDFIL] 
iF FILE ALREADY BEING RENAMED <BY ANOTHER USER CHANNEL) CACPREN], ERROR RETURN 

IF FiLE ALREADY BEING CREATED, SUPERCEDING, OR UPDATED BY ANOTHER USER CHANNEL C ACYSTS JENTRB3 , ERROR RETURN 
READ OLD FILE RIB 

5HECK PRIVILEGES FOR EACH ATTRIBUTE USER IS TRYING TO CHANGE AND PERFORM ANY ACTIVITY REQUIRED 
CHANCE ACCESS TABLE (NAME, EXT, OIR, PRIVILEGES) AND MONITOR BUFFER TO REFLECT ALU NEW ATTRIBUTES 
CALCLSI CALL CLOSEl WHICH CALLS CLOSE INPUT, THEN CLOSE OUTPUT (USES SAME MONITOR BUFFER) 
6K RETURN TO USER 

ABBREVIATED CLOSE INPUT 

IF LOOKUP NOT IN FORCE ON THIS USER CHANNEL CLO0KB3, RETURN 

IF FILE READ COUNT IS NOT UP FOR THIS USER CHANNEL, RETUBN 

DECREMENT FILE READ COUNT CACCCNT] AND CLEAR "READ COUNT UP" FOR THIS USER CHANNEL [DEPRDC: 

IF HEAD COUNT IS NOW FOR FILE (EVEN THOUGH UPDATE MAY STILL BE IN PROGRESS ON THIS OR ANOTHER CHANNEL) 

IF FILE IS MARKED FOR DELETION, ZERO DIRECTORY ENTRY THEN RECLAIM DISK SPACE AND RETURN 

IF OUTPUT CLOSE WILL BE DONE CENTRB OR RENAB], RETURN SO THAT IT WlLL BE DONE 

IF USER DID SOME INPUT UUOS CINPB3IAND NOT JUST A LOOKUP TO LIST DIRECTORY) 

IF ACCESS DATE IS NOT TODAY AND THIS STR NOT HRITE-LOCKEO FOR THIS USER C0EPWLK3, UPDATE RIB AND ACCESS TABLE 

END 
END 
RETURN 



ABBREVIATED OUTPUT CLOSE 

IF NEITHER ENTER NO LONGER IN FORCE ON THIS USER CHANNELCENTRB3N0R FILE BEING RENAMEDCRENMB3, RETURN 
(NEEO TO MODIFY UUOCON TO SET RENMB IN QEVPAT, IS USED TO STORE iN MEMORY) 
IF NEITHER DUMP MODE NOR CALL RESET CDEPRST] 

SAVE NO. OF WORDS OF LAST BUFFER CAKBLBCJ 

WRITE LAST BUFFER CPUSHJ 0UT3 
END 

IF RIB NOT ALREADY IN A MONITOR BUFFER JFROM RENAME) C lOSMBF], READ RIBCAKBPT13 
UPDATE? IF NOT AT LEAST ONE ALLOCATED BLOCK BEYOND LAST 8L0CK WRITTEN. ALLOCATE ONE MORE BtOCK<CLUSTER)FOR RIB 

IF USER IN NOT INHIBITING DEALLOCATION OF UNWRITTEN SPACECCLSDLL3iOEAlLOCATE ALL BUT ONE BLOSK (eLUSTER) 

MERGE DEVICE DAT* BLOCK RETRIEVAL POINTERS INTO MONITOR BUFFER 

IF CALL RESET UU0C0EPRST3, RECLAIM DISK SPACE CCALL RECLAM3THEN fO CLRSTS 

WRITE MONITOR BUFFER(RIB)AS BTH AND LAST*lST RELATIVE BLOCK WRITTEN OF FtLE 

FOR EACH UNIT WHICH FILE PASSES THROUGH, WRITE ALL SAT TABLES HHtCH HAVE CHANCED 

IF FILE IS BEING CREATED CACPCRE] tIE NOT IN A DIRECTORY VET)»TO NOTOLD 

(FILE IS BEING UPDATED OR SUPERCEDED OR RENAMED SO OLD NAME ALREADY tXirS IN A DtRCCtORY) 

IF NEW DIRECTORY CPPBNAHCACCPPB] 315 DIFFERENT FROM OLD DIRECTORY CDEVPPN3,T0 NOTOLD 

REWRITE DIRECTORY BLOCK WITH NEW NAMECNMBNAMCACCNMB3RING3 ,E)(TENSI0N, AND COMPRESSED PILE POINTER 

READ OLD RIB BLOCK IN MONITOR BUFFER AND RECLAIM DISK SPACE tCALL DELRIB3 

TO CLRSTS 

NOTOLOI FIND A FREE WORD PAIR IN NEW DIRECT0RYCDEVUFB3 
REWRITE DIRECTORY BLOCK WITH NEW ENTRY IN IT 
IF CHANGING DIRECTORIES, READ OLD UFD AND DELETE OLD NAME FROM IT 

CLRSTSI CLEAR UNARY MODIFY STATE CODE FOR FILE CACYSTS3 AND RENAME-IN-PROGRESS FLAG CACPREN3 

IF ACCESS ENTRY IS DORMANT (READ COUNT.0 AND NO WRITERS), APPEND ACCESS BLOCK TO SYSTEM DORMANT LIST 

H t I V " *» 



FLOW FOR ROUTINE TO TEST BAD BUOCKSCTSTB4D3 



CALL! MONltOR BUFFER HAS RIB IN IT (TSTBAD HILL WRITE IT) 
BAD LOCICAL BLOCK NUMBER WITHIN UNtTCOEVELB] 
BAD LOGICAL UNIT NUMBER WITHIN STR CDEVEUN3 
fSTBADI CONVERT FROM LOCICAL UNIT WITHIN STR OF ERR0RC0EVEUN3T0 GET UNIT DATA BLOCK ADR. 
00 REDBAb. FOR BLOCKS STARTING AFTER BAD BLOCK ON THIS UNIT 
READ NEXT 8L0CK<N0T INTO MONITOR BUFFER-SKIP READ) 
IF IT READS OK. TO BAOEND 
REOBAOl CONTINUE 

(END OF UNIT) 
6ADEN0I IF BAD REGION NOT YET STORED IN RIBCCRtBELB«B3 

STORE NO OF BLOCKS IN BAD REGION CRieNSBHi LOGICAL UNIT UITHIN STRCRIBEUN]iLOG', BLOCK ADR OF REGtONCRIBEUBl 
WRITE MONITOR BUFFER (RIB) AS flTH AND LAST*t WRITTEN BLOCKS OF FILE 
iF PREVIOUS BAD REGION STORED IN RIB WAS SAME CRIBEUN. RIBNBB.RIBELB3 AS THIS, RETURN 
QUEUE FOR DISK ALLOCATION RESOURCE CDAREO] 
ACAD BAD ALLOCATION BLOCK FOR THIS WAIT ClBNBAT] 
iF ERROR, READ OTHER BAD ALLOCATION BLOCK FQR THIS UNIT CLBOBAT} 

DO SCNBADi FOR ALL BAD REGIONS INSERtED BY MONITOR FOR THIS UNIT CCBATFIR, BATFIR,BATCNT33 
IF NEW BAD REGION STARTS BEFORE OR AT THIS BAD REGION'S START (THIS START-NEW STARt) 
If new REGION ENDS BEFORE THIS BAD REGION BEGINSi TO SCN6AD 
INCREASE THIS BAD REGION COUNT OF BAD BLOCKS BY THIS START-NEM START 
STORE NEW BAD REGION START ON TOP OF THIS BAD REGION START 
to INCREC 
OR IF NEW BAD REGION STARTS BEFORE OR AT THE END OF THIS PAD REGION 
INCREGl If end Of NEW BAD REGION-END OF THIS BAD REGION IS POSITIVE 
INCREASE THIS BAD REGION COUNT BY DIFFERENCE 
END 

iF THIS ARITH. PROCESSOR NUMBER C 3 IS SAME AS ONE WHICH FOUND BAD REGION CBAYAPN3 
IF THIS CONTROLLER NO, CUNYKNM] IS SAME AS ONE WHICH FOUND BAD REGION [BAYNM] 
to StOPOB 
END END 
TO HRTBAT 
END 
SCNBADI CONTiNUE 

Ith|i Is a bad region not recorded before) 

IF there is still room to bat BLOCK FOR BAD REGIONSCBAFFIR] 

Increase no, of distinct bad regions found by monitor cbafcnti 

store no, of bad blocks in THIS BAD REGION CBAYBBC3 
store LOGICAL CONTROLLER NO, WITHIN THIS TYPE CBAYKNM.UNYKNMJ 
StbRE ARITHMETIC PROCESSOR NUMBERCBAYAPN* 3 

STbRE FIRSt LOGICAL OISK ADR WITHIN UNIT OF BAD REGION CBAFBLB3 
STOPUBi OR-TO-HEMORY PHYSICAL UNIT NUMBER BIT HlfHIN CONTROLLER EBAPPUB3 
WRTBATi WRITE OUt THE BAD ALLOCATION BLOCK IN BOTH PLACES ClBNBaT,LB0BAT3 
END 

RELEASE DISK ALLOCATION RESOURCE C0ARE03 
RETURN 



REPEAT LOGICt< 

2 SPACE RECLAIMING SUBROUTINES - DELR1B,RECUAH 

DELRia IS CALLED HITH AN EMPTY MONITOR BUFFER AND A COMPRESSED FtLE POINTER TO RIB AS AN ARC 
HECLAM IS CALLED WITH MONITOR BUFFER ALREADY SETUP WITH FILE RIB 

DELRIBI CONVERT OLD COMPRESSED FILE POINTER TO LOGICAL BLOCK NUMBER AND LOCICAL UNIT 
READ OLD RIB BLOCK INTO MONITOR BUFFER 

RECLAMI QUEUE FOR DISK ALLOCATION RES0URCECAURE03 

60 ALLPTR, FOR ALL RETRIEVAL POINTERS OF OLD FILE (IN MONITOR BUfFCR) UNtIL EOF (ALL • POINTER) 
IF NEXT POINTER HAS ZERO CLUSTER COUNT AND UNJT CHANCE BIT IS ON E 
CHANGE TO NEW LOGICAL UNIT MiTHIN SAME FILE STRUCTURE 
ELSE 

DO SCNSAT, FOR ALL SAT BLOCKS IN CORE FOR THIS UNIT 

iF FIND SAT BLOCK IN CORE WHICH DESCRIBES SPACE TO BE FREED tiPi TO ZERBit 
SCNSATI CONTINUE 

IF FIRST SAT BLOCK HAS BEEN MODIFIED CSABCHC]* WRITE IT BACK ONTO DISK 
READ DESIRED SAT BLOCK INTO CORE 

ADVANCE POINTER tO FIRST SAT BLOCK IN RING FOR THIS UNIT TO NEXT SAT BLOCK IN RIN6 
ZERSATI MARK ALL CLUSTERS REFERRED TO BY THIS RETRIEVAL POINTER AS NOW FREE 

END 
ALLPTRI CONTINUE 

• IF THIS FILE HAD A BAD RECIONCRIBELB N0N-ZER03 

• CONVERT BAD LOGICAL BLOCK ADRCRIBELB3 TO CLUSTER ADDRESS 

• CONVERT NO OF BAD BLOCKS TO CLUSTERSCRIBNBBKROUND tNG UP) 

• MARK ALL CLUSTERS AS IN USE ON BAD UNIT WITHIN STR CRIBEUN3 

• END 

RELEASE DISK ALLOCATION RESOURCE CDAREO] 
RETURN 



DETAILED FLOW FOR RENAME 

IF USER CHANNEL HAS NEVER BEEN CONNECTED TO A FILE BY LOOKUP OR ENTERCLOOKB.ENTRB] , ERROR RETURN 

IF FILE NAMEC0EVFIL3ST0RED IN DEVICE DATA BLOCK IS I, SYSTEM ERROR 

IF ACCESS TABLE IS NO LONGER ATTACHED TO USER CHANNEL (CLOSE DONE) CDEVACC=B] 

SETUP FILE STRUCTURE SEARCH LIST FROM DEVICE NAME USER USED ON LAST LOOKUP OR ENTER ON CHANNEL [DEVNAM] 

FIND OLD FILE NAME IN FILE SYSTEMCCALL FNOFIL AS IF LOOKUP, CREATE ACCESS BLOCK AND INCREMENT READ COUNT] 

IF FILE NOT FOUND. RELEASE CB RESOURCE AND ERROR RETURN 

PRETEND LIKE USER HAD DONE A LOOKUPCLOOKB»1,OCLOSB*0 IN AC NOT MEMORY YET] 
END 
IF USER IS TRYING TO DELETE FILECNAME ARO=0] 

IF USER IS NOT PERMITTED TO DELETE FILE CCHKPRVCFNCOEL] , ERROR RETURN TO USER 

HARK FILE TO BE DELETED WHERE READ COUNT GOES TO ZERO CAKBDEL] 

TO CALCLS 
END 

jF FILE IS MARKED FOR DELETIONCAKBDEL]. ERROR RETURN 
IF USER IS CHANGING DIRECTORYCARG DIFF. ACCUFB], FILE NAMECARG OlFF. NMBNAMCACCNHB]] ,0R FILE EXTCaRG DIFF NMBEXT] 

IF USER CHANNEL HAS MONITOR BUFFER(CALL TO FNDFIL),GIVf IT UP 

STORE NEW DIRECTORY, FILE-NAME AND EXTENSION COEVPPN.DEVFIL.DEVEXT] IN DEVICE DATA BLOCK 

SCAN FILE SYSTEM TO SEE IF NEW NAMECDEVFIL.DEVEXTJEXISTS IN NEW DIRECTORYCACCUFBJCCALL FNDFILCRENAMED] 

CFNDFIL GIVES ERROR RETURN FOR ANY OF THE FOLLOWING REASONSi 

A. NEW NAME EXISTS IN FILE SYSTEM 

B. EVEN THOUGH NEW NAME DOES NOT EXIST, USER DOES NOT HAVE PRIVILEGES TO CREATE IN DIRECTORY 

C. USER DOES NOT HAVE PRIVILEGES TO CHANGE NAME AND/OR DIRECTORY 
0. USER WANTED TO CHANGE DIRECTORY BUT WAS NOT AN UPOATER CENTRB] 
E, DISK QUOTA FOR NEW DIRECTORY WOULD BE EXCEEDED 

FNDFIL CHANGES NAME RINGCACCNMB], DIRECT0RYCACCPPB3, ANDCDEVUFB]FOR ACCESS BLOCK IF OK RETURN]. 
FNOFIL MARKS THIS FILE AS BEING RENAMED CACPREN] MAYBE ALREADY CREATED, SUPERSEDING, OR BEING UPDATED) 
IF ERROR RETURN FROM FNDFIL 

RESTORE OLD FILE NAME, EXT AND DIRECTORY 

RELEASE MONITOR BUFFER 

ERROR RETURN TO USER 
END 
ELSE 

NO SCHEDULE 

IF FILE ALREADY BEING RENAMEOtACPREN],SCHEOUl.E AND ERROR RETURN TO USER 
FLAG FILE IS BEING RENAMEDCACPREN] IN ACCESS BUOOCK 
SCHEDULE 
END 



CLEAR RIB IN MONITOR BUFFER FLAG (IN CASE ON FROM FNOFIL FOR NEW FILE NAME) 

IF USER-CHANNEL nOES NOT LEAVE A MONITOR BUFFER, QUEUE FOR ONE AND FLAG CIOSMBF IN 10S3 

rLd OLD FILE RIB CAKBPTn INTO MONITOR BUFFER InD FLAG USER-CHANNEL AS RIB IN MONITOR BUFFERCDEPRI83 

SET RIB IN MONITOR BUFFER FLAGCDEPRIB] FOR THIS USER CHANNEL 

EXCHANGE OLD FILE IN RIBCRIBNAM] WITH NEW NAME IN DEVICE DATA BLOCK CDEVFIU] 
FXCHANGE OLD EXT IN RIBCRIBEXT] WITH NEW EXT IN DEVICE DATE BLOCK CDEVEXT3 

Exchange old ppoj-prog in ribcribppnj with new proj-prog in dev data blockcoevppn: 

SET logical block MO WITHIN STR OF NEW UFB BLOCKCUFBPTICACCUFB]] 

jF USER IS TRYING TO CHANGE FILE PROTECTION 

IF USER IS NOT PERMITTED TO CHANGE THE FILE'S PROTECTIONCCHKPRVCFNCCPR33, ERROR RETURN 

MODIFY MONITOR BUFFER AND ACCESS BLOCK WITH NEW PROTECTION 
END 
IF USER IS TRYING TO CHANGE OTHER ATTRIBUTES _ _ 

IF USER IS NOT PERMITTED TO CHANGE OTHER ATTRIBUTES CCHKPRVCFNCCAT33, ERROR RETURN 

MODIFY MONITOR BUFFER AND ACCESS BLOCK WITH NEW ATTRIBUTES 
END 
IF USER IS TRYING TO ADD ALLOCATION TO THE FILE CARG ,CR. AKBALC3 

IF USER IS NOT PERMITTED TO ALLOCATE ADDITIONAL SPACE, ERROR RETURN 

ALLOCATE SPACE AND MODIFY MONITOR BUFFER AND ACCESS BLOCK 
OR IF USER IS TRYING TO DEALLOCATE SPACE FROM THE FILE CARG.L . AKBALC3 

IF USER IS NOT PERMITTED TO DEALLOCATE, ERROR RETURN 

DEALLOCATE SPACE AND MODIFY MONITOR BUFFER AND ACCESS BLOCK 
OR IF USER IS TRYING TO TRUNCATE DATA FROM THE F JLECARC.L, ACCHRT3 

IF USER IS NOT PERMITTED TO TRUNCATE DATA FROM THE FILE, ERROR RETURN 

TRUNCATE SPACE AND MODIFY MONITOR BUFFER AND ACCESS BLOCK 

jF FILE is BEING CREATED OR SUPERSEDING BY THIS USER CHaNNELCENTRB , AND, < ACCCRE.OR , ACCSUP) 3 
SET CLOSE TO DO AUTOMATIC DEALLOCATION CCLEaR SUPPRESS DEALLOCATION BIT IN UU03 

ELSE (LOOKUP-RENAME OR UPDATE) 

SET CLOSE TO SUPPRESS AUTOMATIC DEALLOCATION [SET SUPPRESS OEALUOCATION BIT IN UU03 

END 
CALCLSl (DO NOT TOUCH FLAGS SAYING LOOKUP AND/OR ENTER IN FORCE(ONE MUST BE ON) 

CALL CLOSEl IN UUOCON WHICH CALLS CLOSE INPUT THEN CLOSE OUTPUT(USES MONITOR BUFFER) 

OK RETURN TO USER 



CLOSE INPUT - DETAILED FLOW 
IF LOOKUP NOT IN FORCE ON THIS USER CHANNEL CLOOKB], RETURN 

r 11^^^J^.^°J'^'^"^ ^^°'^^ fO" ^H'S USER CHANNEL. RETURNtSYSTEM ERROR?) 
iSES^'-FoS^^gR^^L^ScrR^^SuR^^E^^^BjE"^? "^" "^^'^^^ COEPROC^IrE^Sr^^^tI^^M ERROR,, 
NO CONTROL C 

DECREMENT FILE READ COUNT CACCCNT] 
CLEAR "READ COUNT UP" FLASCDEPRDC: FOR THIS USER CHANNEL 

' .P"?LE°irHlR^E'S"F0%'D^V'^TlSN°1uKBDEL*I' ''' ''''' " '^ "°""^ °^ '"'' °' *^°^«" =«*^«^^' 

miJ^FoR^iaife S?^%';souRc1:JuS?Sr°' '"''"' ''''' "" °^^ ^'^"""^ 

°°.l^??iS'/2?TSi'=|!J'-2" "^ "'"°"'^ ''■LE: STRUCTURE WHICH FILE STARTS IN) 
ZEROiRI CONTINUE *''° EXTENSIONCNAMARGJ.TO ZERNAM 

RELEASE ALTER UFD RESOURCE 
to FREACC 

«RNAM. ^£«JS^SSHi°XS51^??N^lfe5 llir?. ITlVcl' "'''' ''° ''''''''' '^ ""'^° «^" «'« *ND RECLAIM SPACE, 
BLOCK MOVE ALL ENTRIES AFTER UP TWOCNAMSIZ=.Z] IN UFD BLOCK AND iERO THE i 4«iT Tun 
Ssm"" ^^„^««"VED<HITHIN EACH UFO BLOC^ ONLn ASfe'HERr^L'GS^lRLr'ENS JrSLOCK, 
RELEASE ALTER UFD RESOURCE 

TREACC. ?S?°A?JfsrBt:H'SS fTtl'll'sT '"'''" ''''' "*^^ "^^'" 
RETURN 
END 

IFACCESS BATE IS NOT TODAY CTHSDATJ uiHtcTUHT) 

CHANSE IT TO TODAYS DATE IN ACCESS BLOCK 
QUEUE FOR MONITOR BUFFERCMOREOa 
READ FILE RIB INTO MONITOR BUFFER 
CHANGE ACCESS DATE IN MONITOR BUFFER 
REHRITE RIB 

RELEASE MONITOR BUFFER 
END 
END 



OETAiUED PLOW FOR CLOSE OUTPUT (RESET, RELEAStiCLOSEiRENAME. ENTER, INlTiOPEN) 

IF NEITHER ENTER NO LONGER IN FORCE ON THIS USER CHANNEL CENTRB] NOR RENAME UUOCRENHBl, RETURN 
(NEEb TO MODIFY UUOCON TO SET RENHB IN AC NO NEED TO STORE) 
MARK ENTER NO LONGER IN FORCE IN AC BUT NOT YET IN MEMORY CENTRBJ 

IF THIS USER CHANNEL NO LONGER HAS AN ACCESS ENTRY COEVACC'BI, RETURN (SYSTEM ERRORJJ 
IF THIS USER CHANNEL MODE IS DUMP CD.DRJ OR THIS UUO JS RESET COEPRST], tO NOOUTP (00 NOt OUfPUT) 
IF NO OUTPUT BUFFERS HAVE BEEN SET UP. TO NOOUTP 
CSEE LINES 1019-1041 OF 4S,50 DISK SERVICE3 
STORE WORD COUNT OF UAST BUFFER IN ACCESS TABLE CAKBLBCJ 
IF LAST BUFFER HAS WORD COUNT, TO NOOUTP 
WRITE LAST PARTIAL BUFFER CPUSHJ 0UT3 
WAIT UNTIL 10 FINISHED CPUSHJ WAIT3 
NOOUTPl IF THIS USER CHANNEL DOES NOT HAVE A MONITOR BUFFER CI0SMBF3 

QUEUE FOR MONITOR BUFFER 

SET THIS JOB HAS A MONITOR BUFFER FLAG C10SMBF3 
END 

IF RIB NOT IN A MONITOR BUFFER EOEPRtB], READ RIB INTO MONITOR BUFFER CACCPT13 
MERGE DEVICE DATA BLOCK POINTERS INTO RIB IN MONITOR BUFFER 
IF RESET UUO C0EPRST3 

CALL RECLAM (RECLAIMS ALL STORAGE FOR RIB IN MONITOR BUFFER) 

TO CLRSTS 
END 
iF NO MORE ALLOCATED BLOCKS CAKBALC] BEYOND THE HIGHEST WRITTEN BLOCK CALCHRT] 

ALLOCATE 1 MORE BLOCK (CLUSTER) FOR SECOND RIB 

ADO NEW POINTER OR INCREASED LAST POINTER TO DEVICE DATA BLOCK 

DECREMENT NO. OF FREE BLOCKS IN UFD CUFBTAL: 

INCREMENT NO. OF BLOCKS ALLOCATED TO FILE CAKBALC] (BUT NOT NO'. OF BLOCKS HRITtENCACCWRT3 } 
END 
iF USER JS NOT INHIBITING DEALLOCATION OF UNWRITTEN SPACE ECLSDlU 

DEALLOCATE ALL BUT FIRST UNWRITTEN BLOCKS PROM END OF FILE (MAYBE MORE THAN ONE POINTER) 

CHANGE POINTERS IN DEVICE DATA BLOCK AND MONITOR BUFFeR 

STORE NEW HIGHEST ALLOCATED BLOCK (NOT COUNTING SECOND RlB) IN ACCESS BLOCK 
END 

MERGE DEVICE DATA BLOCK POINTERS WITH RIB IN MONITOR BUFFER 
STORE NO, OF WORDS (NOT BLOCKS) WRITTEN [ACCHRT«1284-AKBLBC] IN MONITOR BUFFER CR!BSIZ3 

• IF USER CHANNEL HAD ANYERRORS WHILE ACCESSING FILE WHICH INDICATED DATA IS BAD 

• (SO That user should get a login and logout error message* 

• CI0SSCE,i05BRE.IOSHRE,I0SHWE.I0SHPE BUT NOT DEVICE OR CHANNEL ERR0RS3 

• SET CORRESPONDING FLAG FOR FILE IN RlBCRIPSCEiRIP8RE,RIPHRE,Rf PHHE,RIPHPE3 

• END 

• IF THIS USER CHANNEL HAD TROUBLE WITH FILE INDICATING THAT SURFACE IS PROBABLY BAD 

• (HARDWARE DETECTED PARITY ERRORSC IOSHRE,!oSHWE3 OR POSITIONING ERRORCIOSHPEl) 

• (BUT NOT DEVICE ERROR OR CHANNEL ERROR OR SOFTWARE CHECKSUM ERROR OR BAD RETREIVAL ERROR) 

• TEST BAD REGION FOR EXTENT CCALL TSTBAD^i RECORD IN RiB THEN WRITE RIBS 

• ELSE 

• WRiTE MONITOR BUFFER(RIB) AS BTH AND LAST*1 WRITTEN BLOCKS OF FILE 

• END 

• IF ANY ERRORS FOR FILECIOSSCE, lOSBRE. lOSHRE, lOHWE. I0SHPE3NEE0ING LOGIN MESSAGE 

• QUEUE FOR ALTER UFD RESOURCE [AUREQ] 

• READ UFD RIB 

• SET COORESPONOING ERROR FLAG FOR LOGIN TO SEE (RIQSCE,RIQ8RE,RIQHRE,RlQHME,RlOHPE] 



• WRITE UFD RIB 

• END 



QUEUE FOR DISK ALLOCATION RESOURCE tDAREQ]<ST|LL HAVE MONITOR BUFrCR NITH «!• IN IT CHBReO}) 
DO ALLPTR, FOR ALL RETRIEVAL POINTERS IN MONITOR BUFFER 

IF POINTER IS A NEH UNIT AND THE SAT TABLE FOR THAT WlT HAS BEEN MOOIFICB CSAfCHM 

CLEAR SAT BUFFER BEEN MODIFIED BIT 
ENO 
ALLPTRl CONTINUE 

RELEASE DISK ALLOCATION RESOURCE CDAREQ] 

ir FiLE IS BEING CREATED CACPCRE3 J I .E. NOT IN A DIRECTORY YtT), fg NOTFOUO 
(FILE BEING UPDATED, SUPERCEDED OR RENAMED SO OLD NAME ALREADY EXlSTt IN A Ol«CtO«V» 

IF NEW DIP NAME(PR0J.PR0G>CPR8NAMtACCPPB3] It OIFFERCNT FROM OLD OlReOEVPPNSCRCNAHt UUO CHANOCD). tO NOtOLO 
DO OLDPPB, FOR EACH PROJ-PROG BLOCK IN CORE FOR SYSTEM ynmnnoi, iv noTUtu 

IF FIND OLD DIRECTORY NAME {PROJ PROG) tPPBNAM«0EVPPN3, TO fNDP^B 

OLDPPBI CONTINUE 

SYSTEM ERROR 

FNDPPBI 00 SAMSTR. FOR ALL UFB CORE BLOCKS HtTH tHIS PROJ'PROG NUMBER 

..u»T.. -„iJiL',^° * "" ^'■°" ^""^SN3 IN SAME FIlE STRUCTURE AS OLD (ANfi NEH) FILC tO rNOUFI 
SAMSTRI CONTINUE 

SYSTEM ERROR 

FNDUFBI OUEUE FOR ALTER UFO RESOURCE CAVREQS 

DO SCNUFDt FOR ALL BLOCKS OF UFO 

READ NEXT UFD BLOCK INTO MONITOR BUFFER 

IF FIND OLD NAME CDEVNAM|0EVEXT3 IN UFO BLOCK, TO FNDNAM 

SCNUFDI CONTiNUE 

RELEASEiLTES^FS^ESOURCE^SuREOj""* ' **" "*''"'* '^ *"""" """ "^''*''" ""^ ^'" '"^'" *•*" ""* ""'''"'' 
to NOTOLO (PRETEND LIKE THERE IS NO OLD FILE) 

FNDNAMI REMEMBER OLD COMPRESSED FRE POINTER FOUND WITH OLD NAME IN UFD JFOR CALL TO OELRIB) 
CHANGE FILE NAME IN DIRECTORY TO NEW NAME CNMBNAMCACCNMBSRING] <fN CORE BlFrCRENt 
CHANGE FILE EXTENSION IN DIRECTORY TO NEW EXTENSION tNMBEXTCACCNMB3RlNG3 (IN CORK DIFFERENT) 
SeJS??e'S?d''I!oIS Hi'. :VuTt" 1^41'"°'' '° ''' """""" ''°^*'^" CAKBPTI.ALBUNIS (MUST BE DIFFERENT, 
RELEASE ALTER UFO RESOURCE CAUREQ3 
CALL DELRIB WITH ARC OF REMEMBERED OLD COMPRESSED FUE POINTER (READ RIB AND RECLAIM ALL SPACE) 

Tu Cl>HS T 5 



NOTOLDI QUEUE TOR A1.TER UFD RESOURCE CAUREQ] 

00 SCNFRE, FOR ALL UFD BLOCKS IN NEW DIRECTORY CUEBPTlCOEVUFB]] 
IF LAST NAME PAIR IN UFO BLOCK IS UNUSED (0>. TO FNOFRE 
SENFREI CONTINUE 

READ UFO RIB INTO f«ONITOR BUFFER 

IF N9T ANOTHER FREE BLOCK IN FILE, ALLOCATE ANOTHER CRlBALC] TO UFO FliE 

UPDATE NO. OF BLOCKS WRITTEN CRIBWRT] IN UFQ FILE 

DECREMENT NO, OF FREE BLOCKS IN THIS UFO IN THIS FILE STRUCTURE. CUFBTAL3 

REWRITE UFO RIB 

STORE NEW FIRST RETRIEVAL POINTER TO UFD IN UFD BLOCK CUFBPT13 

CONVERT CLUSTER COUNT TQ BLOCK COUNTCUFBPTIJ 

iF UFD NOW HAS MORE THAN ONE POINTER OR BLOCK COUNT OVERFLOWED COUNT FIELD 

CLEAR THIS UFD HAS ONLY ONE RETRIEVAL POINTER CUFBtPT] 

END 

READ NEWLY ALLOCATED BLOCK INTO MONITOR BUFftR AND CLEAR IT OUT 
FNOFREI DO SCNZER, FOR ALL NAME PAIRS IN THIS UFD BLOCK 

iF FIND A ZERO ENTRY. TO FNOHER 
SCNZERI CONTINUE 

SYSTEM ERROR 
FNDZERI STORE NEW NAMEtNMBNAMCACCNMB]RING] AND EXTENSION IN N£W SLOT IN DIRECTORY 

COMPUTE ikND STORE NEW COMPRESSED FILE P0iNTEfiCAK8pTl/AKBi;N13 

REWRITE DIRECTORY BLOCK WITH NEW ENTRY ADDED TO IT 

RELEASE ALTER UFD RES0URCECAUREQ3 
CLRSTSI CLEAR UNARY MODIFY STATE CODE FOR FIlECACYSTS^ IN ACCESS BLOCK AND RENAME IN PROCRESSCACPREN] 

IF ACCESS BLOCK IS NOW DOMINANT (READ COUNTb0,MOOIFY«0) 

IF ACCESS BLOCK NOT ALREADY ON DORMANT LIST (SYSTEM ERROR), APPEND ACCESS BLOCK TO SYiSTEM DORMANT LIST 

END 

RELEASE MONITOR BUFFERCMQREQ] 

RETURN 



THE UUO CODE FOR INPUT AND OUTPUT IS DIVIDED INTO 5 PARTSI 

UUOPTRt COMPUTE THE LOGICAL BLOCK NEEDED FOR I/O 

UUOPWQI PUT FILE INTO POSITION WAIT QUEUE, IF POSITIONING CANNOT BE 

OONE NOW. 
UUOPOS! SET UP AND ISSUE POSITIONING COMMAND IF NEEDED 

UUOTWQJ PUT FILE INTO TRANSFER WAIT QUEUE, IF TRANSFER CANNOT BE DONE NOW* 
UUOTRN« SET UP AND ISSUE TRANSFER COMMAND 

UUOPTfil 

• IF OUTPUT 

• IF THIS STR IS WRITE LOCKED FOR THIS USER CDEVWLK], SET ERROR PtAG CI0BKTL3 AND RETURN TO USER 

• IF NO, OF FREE BLOCKS IN UFD GONE TO 8 CUFBTAU3 

• TYPE WARNING MESSAGE BUT ALLOW WRITING TO CONTINUE 

• TO UUOPWQ 

• OR IF UFD LOGGED-IN DISK QUOTA GONE PAST FILE STRUCTURE OVERDRAW 

• SET SOFTWARE ERROR FLAG (IOBKTL: 

• EXIT 

• END (WAIT TILL INTERRUPT TO DECREMENT) 

IF RAN OUT OF CLUSTER PTRS, READ CLUSTER POINTERS 
IF THIS PTR IN CORE IS NOT AN EOF, TO UUOPWQ 
FLAG EOF 
EXIT 

UUOPWQI FLAG ACTIVE USER 10 
INHIBIT SCHEDULING 
TURN ALL DISK PI'S OFF 

IF THIS is FIXED HEAD QEVICEi TO UUOTWQ 

IF UNIT IS IN SW STATE, CLEAR THE QUEUE (ONLY ONC FILE CAN BE IN IT) 
IF KONTROLLER is idle, to UUOPOS 
SET FILE STATE TO PW 
iF UNIT !S IDLE, SET IT TO PW STATE 
ADD FILE TO END OF SW/PW QUEUE FOR UNIT 
TO UUOEXT 

UUOPOSI jF UNIT ALREADY AT DESIRED POSITION, TO UUOTWQ 
SET STATE OF UNIT TO P 
SET STATE OF FILE TO P 
TURN ALL DISK PI'S ON 
ENABLE SCHEDULING 
ISSUE POSITIONING COMMAND 
EXIT 

UUOTWQI IF CHANNEL IS IDLE, TO UUOTRN 
SET UNIT STATE TO TW 
SET FILE STATE TO TH 

ADD FILE (DDB) TO END OF TW QUEUE FOR CHANNEL 
to UUOEXT 

UUOTRNI SET CHANNEL STATE TO BUSY 

SET KONTROLLER STATE TO BUSY 

SET UNIT STATE TO T 

SET FILE STATE TO T 

TURN ALL DISK PI'S ON 

ENABLE SCHEDULING 

to StARTT (COMPUTE CHANNEL COMMAND BIT AND START TRANSFER) 
UUOEXTl tURN ALL DISK PI'S ON 



ENABLE SCHEDULING 
EXIT 



INTERRUPT PROCESSING FILlNTi 

1. POSITIONING INTERRUPTS 
POSTSTI START DATA TRANSFER 

2i DATA TRANSFER INTERRUPT 

POSTSTI QUEUE ANY UNITS WHICH HAY HAVE REACHED POSITION DURING DATA TRANSFER 
POSOONI FINISH BOOKEEPING ON DATA TRANSFER, WAKE UP USER IF IN 10 WAIT, ETC. 
PIKPOSI FOR EACH UNIT WHICH NEEDS POSITIONING ON THE CONTROLUER PICK A 

WAITING FILE TO START POSITIONING, 
PIKTRNI SCAN ALL UNIT ON ALL CONTROLLERS ON THIS CHANNEL AND 

PICK THE FASTEST ONE TO START TRANSFER 

NOTEi PIKPOS USUALLY PICKS POSITIONING AND TRANSFER ON THE 

BASIS OF WHICH WILL MINIMIZE THE IDLE TIME OF THE DEVICE', 
HOWEVERi EVERY MTH DATA TRANSFER PIKPOS PICKS A FILE 
WHICH HAS BEEN WAITING THE LONGEST ON EACH UNIT, (FRONT 
OF PW QUEUE FOR EACH UNIT> INSTEAD OF THE FASTEST IN 
The ENTIRE PW QUEUE -FOR EACH UNit, IN OTHER WORDS, 
EVERY MTH DATA INTERRUPT POSITIONINGS ARE SELECTED 
ON THE BASIS OF BEING FAIR INSTEAD OF BEING FAST, 
A DIFFERENT COUNTER IS KEPT FOR PIKTRN, SO THAT EVERY 
NTH TIME THE LONGEST WAITING TRANSFER RATHER THAN THE 
SHORTEST LATENCY IS PICKED, 

IDEPENDENT ROUTINE FLOW 

HERE ON AN INTERRUPT 

IF ANY PECULIAR TYPE OF ERRORS, TAKE CORRECTIVE MEASURES (SUCH AS RECALIBRATE) 
!F END OF CYLINDER REACHED AND MORE TO TRANSFER 

STORE NEW LOGICAL BLOCK WITHIN UNIT [C(UNIBLI<)3 

STORE NEW CYLINDER POSITION FOR UNIT CC(UNICYL)] 

ISSUE 10 COMMAND TO POSITION TO NEXT CYLINDER 

COMPUTE NEW RESIDUE CHANNEL COMMAND LIST 

DISMISS INTERRUPT 
END 

IF THIS IS A POSITIONING INTERUPT CAUSED BY A MID DATA TRANSFER 
POSITIONING 

START UP REST OF DATA TRANSFER 

DISMISS INTERRUPT 
END 

SETUP The following information for DEVICE INDEPENDENT CODEj 

A, BITS FOR POSITIONS WHICH JUST FINISHED ON THIS CONTROLLER 

8, IF A DATA TRANSFER INTERRUPT, UNIT NUMBER <JUST FOR CHECKING) 

C, ERROR FLAG IF ANY ERRORS IN T, HARDWARE ERRORS IN Tl 

D, FUNCTION CODE LAST GIVEN TO CONTROLLER {REASON FOR INTERRUPT) 
PUSHJ TO DEVICE INDEPENDENT CODE CFILINT] 

DISMISS INTERRUPT 



V0B6 ?IUINTi 

VBB3 POSTSTI IF NO MORE POSITIONER COMPLETED BITSi TO POSOON 

VBB3 GET NEXT POSITIONER COMPLETED UNIT NUMBER ON THIS CONTROLLER 

V003 IF UNIT WAS IDLE 

VBB3 IF UNtT IS NOT A DISK PACK. HALT 

V8«3« FLAG TO READ HOME BLOCK BEFORE NEXT lO 

VBB3 OR IF UNIT JUST FINISHED SEEK <IN STATE S> 

V0B3 IF NO MORE FILES IN PW-SW QUEUE FOR THIS UNIT 

V0B3 SET STATE OF UNIT TO IDLE 

VBBS ELSE 

VBB3 SET STATE OF UNIT TO PW 

V0B3 END 

V0B3 OR IF CHANNEL IS BUSY 

VBfl6 TURN OFF ALL DJSK PI'S 

V0fl3 SET STATE OF UNIT TO TH 

VB03 SET STATE OF FILE TO tW 

V0B3 ADO FILE TO END OP TWO FOR CHANNEL 

V006 TURN ON ALL DISK PI'S 

V003 ELSE 

VBB3 SET STATE OF CHANNEL TO BUSY 

V0B3 SET StATE OF CONTROLLER TO BUSY 

VBB3 SET STATE OF UNIT TO T 

VB83 SET STATE OF FILE TO T 

VBB3 COMPUTE CHANNEL COMMAND LIST 

VB03 START DATA TRANSFER 

VB03 END 

VBB3 TO POSTST 



V003 POSOONI IF INTERRUPT HAS JUST FOR POSITIONING ANO NO EKRORS, RETURN AND OUNISS |NT', (TRJkNSrJCR ALRtAtV •fARffD) 
IF ANY ERRORS 

or;to-memory all hardware error flags to soft error horo for unit cuNitorj 

INCREMENT ERRORS ON THIS CHANNEL CCHNECT3 

IF STILL NOT TOO MANY CONSECUTiVE SOFT ERRORS, TO fTARtE (DHNECT .LESS DiKtRYS 

ORiTO MEMORY ALL HARDWARE ERROR FLAGS tO HARD RRROR WORD rORUfjiT tUNICRRJ . , . . , 

COMPUTE HOW MANY BLOCKS TRANSFERRED BEFORE ERROR OCCURRED USlNO CHANNEL CONTROL MO^IO CetClSONlOC)*.)) 

IF BUFFERED MODE AND NOT MONITOR I0> ADVANCE BUFPCRS 0V NUMSER OF GOOD ILOCKS 

IF CHANNEL ERROR CCHNERRl. SET USER CHANNEL DEVICE ERROR tlOOEERI 

IF PARITY ERROR CPARERRJ, SET USER CHANNEL OAT* ERROR tlOOTERl 

IF POSITIONING ERROR CPOSERRli SET USER CHANNEL DEVICE ERROR CtODCRRl 

IF OTHER DEVICE ERROR COEVERR^i SET USER CHANNEL DEVICE ERRQR ^lOOCRRJ 

IF BUFFERED MODE ANO NOT MONITOR lOi ADVANCE BUFFER CONTAINING ERROR <*ND STORE ERAOR IITI IN IW^PkR) 

IF PARITY ERROR CPARERR3 

iF READING. SET USER CHANNEL HARDWARE DETECTED READ ERROR CigSHRE] 

If writing, SET USER CHANNEL HARDWARE DETECTED WRITE ERROR ClOSHWEl 

OR IF POSITIONING ERROR CPOSERR] 

SET USER CHANNEL POSITIONING ERROR ClOSHPE} 

END 

IF LOGICAL BLOCK OF ERROR IS NOT ALREADY STORED IN DEVICE OATA^BLIQCK COEVELB] 
COMPUTE LOGICAL BLOCK IN WHICH ERROR OCCURRED USING CHANNEL eONTROL HORO 

STORE BAD LOGICAL BLOCK NUMBER IN DEVICE DATA BLOCK FOR HARKING BAT BLOOK At CLOtS {OEVELBI 
STORE LOGICAL UNIT NUMBER WRITTEN ON WHICH THIS ERROR OCCURRED COEVEUN^UNYLUNl 

END 

IF THIS IS IN 10 WAIT, WAKE IT UP tSETIOD] 

If error logging PROCRAH is running. ANO IS IN ERRQR WAIT, WAKE IT iif 

TO SETlDL 
END ^ ... 

iF THIS is FIRST BLOCK OF A GROUP CI0SFIR3 AND THIS OPERATION WAS A READ tlORil AND NOt HONtfOR lo tMNiOBTS 

clear first block of a group flag ciosfir] 
if dump mode. get core address of block c0evdmp3 
if buffered mooei get core address of block from 

compute 36 bit exclusive or of some cunyckn3 of the words of this first block 
compare the low order c 3 bits of result with checksum stored in retrevial pointer 
if not a match'. 
Increase count of number of software checksum errors for this unit cuninsci 

SET BLOCK to LARGE (RAThER THAN DEVICE OR DATA ERROR) FDR USER CHANNELII0BKtL3 

SET UNCHANNEL ERROR FLAG FOR CLOSE CiOSSCE3 

If error logging program is running ANO IS IN ERROR WAIT* WAKE It UP 
END 
END 

If soft error count is now zero CCHNECT3 or SOFTWARE CHECKSUM FaIlED 

IF ERROR LOGGING PROGRAM IS RUNNING AND IS IN ERROR WaIT. WAKE IT UP 
END 

V003 DECREASE FAIRNESS COUNTS FOR POSITIONING AND TRANSFERS ON THIS CONTROLLER 

V003 IF FiLE MODE IS DUMP MODE 

V003 ELSE 

V003 IF JOB IN 10 WAIT. WAKE JOB UP 

V003 ADVANCE BUFFERS BY NUMBER OF BLOCKS TRANSFERRED 



VB03 IP NO MORE EMPTY INPUT BUFFERS OR FULL OUTPUT BUFFERS, TO SETIDU 

V003 END 

VBBS tF EXHAUSTED THIS GROUP RETRIEVAL POINTER 

V0fl3 NEXPtRi IF NEXT GROUP RETIREVAL POINTER NOT IN CORE. To SETIOL 

VeeS IF NEXT PART OF FILE IS ON ANOTHER LOGICAL UNIT WtTHIN FILE STRUCTURE 

V0B3 SETUP POINTERS TO NEW UNIT CDDBUNI] 

VeeS TO NEXPTR 

V0eS END 

VBB3 IF NEXT POINTER IS AN EOF, TO SETIDL 

V0«3 END 

V003 iF THIS CONTROLLER DOES NOT DO POSITIONING 

V0B3 AOD FtLE TO END OF TWO 

V003 SET UNIT TO PW STATE 

V003 TO PIKPOS 

V003 END 

V003 SETIDLi SET STATE OF UNIT TO IDLE 

V003 SET STATE OF FILE TO IDLE 

V003 !F CONTROLLER IS FIXED HEAD, TO PIKTRN 



vaes piKPosi look at next unit in ring on this controller 



V003 
V0^3 

vans 

V3liI3 
V0PI6 

VHH3 

V003 
V0K3 
V0S3 
V003 
V0(!3 
V0(!3 
V003 
VB«7 
V003 
V003 
VI3fl3 

vans 

V003 

vaes 

V0CI3 
VI303 
V0I!3 
V0I!3 
V003 
V0Z3 

vafi3 

V003 
V0O6 
V003 
V007 

vae? 

V006 
V003 



V003 

V0ei3 
vees 

V003 
V003 

V0e3 



IF this unit in neither ph nor sw state, to pikpno 

PWQLUPI LOOK at next FILE IN PW-SW QUEUE FOR THIS UNIT 

IF THIS FILE ACCESS IS FOR CURRENT CYLINOER OF ITS UNIT 
DELETE FILE FROM PW-SW QUEUE 
SET UNIT STATE TO TW 
SET FILE STATE TO TW 
TURN OFF ALL DISK PI'S 

ADD FILE TO END OF TW QUEUE FOR THIS CHANNEL 
TURN ON ALL DISK PI'S 
TO PIKPOS 
"" irJMafo'^lhL'I.JS^ CLOSEST SO FAR TO CURRENT CfLINDER 

Kt'TLnHtn THIS rlLrt 

REMEMBER PREVIOUS FILE IN QUEUE 

REMEMBER HOW CLOSE THIS FILE IS TO CURRENT CYLINDER 

IF NOT TIME TO BE FAIR AND MORE FILES ON THIS UNlT, TO PWOLUP 

REMOVE FILE FROM PW-SW QUEUE FOR THIS UNIT " 

SET UNIT TO P STATE 

SET FILE TO P STATE 

START POSITIONING ON THIS CONTROLLER 

IF MORE UNITS ON THIS CONTROLLER RING TO LOOK ATi TO PIKPOS 



PIKPNDI 



PIKTRNI SET CONTROLLER WHICH FINISHED DATa TRANSFER TO IDLE 

IF NO FILES IN TWQ FOR THIS CHANNEL. TO KONJDL 
TWQLUPI LOOK AT NEXT FILE IN TWQ FOR THIS CHANNEL 
!F THIS FILE HAS SHORTEST LAtENCV SO FAR 
REMEMBER LATENCY TIME 
REMEMBER THIS FILE 
REMEMBER PREVIOUS FILE IN QUEUE 
END 

IF NOT TIME TO BE FAIR AND MORE FILES IN TWQ, TQ TWQLUP 

SET CONTROLLER TO BUSY StATE 
TURN OFF ALL DISK PI'S 
REMOVE FILE FROM TW QUEUE FOR CHANNEL 
SET UNIT TO T STATE 
SET FILE TO t STATE 
TURN ON ALL DISK PI'S 
STARTTI COMPUTE CHANNEL COMMAND LIST 

"^J"ssM^^s^?^Gi^°?gR^AS§KEii°^p ^^gi?'g^oSK^°,N°"js^;5p^[givfi?? ~" """'"^ '" ^"^'°"^ 

IF BUFFERED MODE. GET CORE ADDRESS OF FIRST BLOCK IN GROUP t] 
i2!I=^" u'jr EXCLUSIVE OR OF SOME tUNYCKN] OF THE WORDS 
^^STORE LOW ORDER I 3 BITS IN BYTE POSITIONS C 3 IN CALLED RETREiVAL POINTER IN DATA BLOCK 

= T!2»r?°«J?''S?.''°!i'*'^ "" ^"'S CHANNEL CCHNECT3 
STARTEl START DATA TRANSFER 
to SETFAR 

KONIOLi SET STATE OF CONTROLLER TO IDLE 

SETFARl F FAIRNESS COUNT FOR POSITIONING ON THIS CHANNEL COUNTED OUT. RESET IT 
^ETSR*r?D^?lM?s%"^lN;E°SRjp\*r^"^ °' '''' CHANNEL^feouST^E^^^guJr^ES^TIt '^ 



flow for file structure uuo - struuo 
call; 

MOVE ACtCXklO N.LOC] 

CALL ACiCSIXBIT .STRUUO,] OR CALLI AC, 50 

N IS THE NUMBER OF WORDS IN THE ARGUMENT LIST STARTING AT 
LOCATION LOC'. FOR FIXED LENGTH ARGUMENT LISTS. N MAY BE 0. 

THE FIRST WORD SPECIFIES THE FUNCTION REQUESTED. 

FUNCTION* a FOR SETSRC 

1 FOR DEFFST 

2 FOR LOKFST 

3 FOR REMFST 



SETSRC DEFINES THE FILE STRUCTURE SEARCH tIST FOR THE JOB 

^OTEt tHE USER MAY DETERMINE HIS CURRENT FILE STRUCTURE SEARCH 
LIST BY USING THE JOBSTR UUO. HE MAY UNLINK HIMSELF 
FROM A FILE STRUCTURE BY LEAVING IT OFF THE NEW 
FILE STRUCTURE SEARCH LIST. THE USER MAY SPECIFY 
HIS PROJECT LIBRARY OR SYS TO BE INCLUDED IN HIS FILE 
STRUCTURE SEARCH LIST. PROJECT LIBRARY MUST BE FILE 
STRUCTURE NAME DSK FOR LEVEL D, AND MUST BE HIS PROJECT 
NUMBER AND PROGRAMMER NUMBER Z, MAXIMUM NUMBER OF FILE 
STRUCTURES. NOT INCLUDING PROJECT LIBRARY OR SYSi IS 9, 



ARGUMENTS! THREE WORD BLOCKS: 

FIRST WORD « SIXBIT FILE STRUCTURE NAME LEFT JUSTIFIED 

SECOND WORD E PROJECT^ PROGRAMMER NUMBER 

THIRD word: BIT 0.1 IF SOFTWARE WRITE PROTECTION REQUESTED 

BIT 1.1 IF NO CREATE ON THIS FILE STRUCTURE REQUESTED 
(UNLESS THE SPECIFIC FILE STRUCTURE IS OPENED) 

ERROR RETURNS! 1 OR MORE FILE STRUCTURES DON'T EXIST 

1 OR MORE FILE STRUCTURES SINGLE ACCESS ONLY 
TOO MANY ENTRIES 

TASKS! IF ARGUMENT LIST OUT OF BOUNDS, TO ERR 

VERIFY THAT ALL FILE STRUCTURES IN THE USER'S SEARCH LISt EXIST 

IF ANY FILE STRUCTURE IS SINGLE ACCESS AND MOUNT COUNT NO 0t TO ERR 

FOR EACH FILE STRUCTURE ON THE NEW SEARCH LIST 

IF THE FILE STRUCTURE IS NOT ON THE USER'S OLD FILE 
STRUCTURE SEARCH LIST, INCREMENT THE MOUNT COUNT 

FOR EACH FILE STRUCTURE NO LONGER ON THE SEARCH LIST, 
DECREMENT THE MOUNT COUNT 

MAKE THE NEW LIST THE SEARCH LIST 

EXIT 



DEFStR DEFINES k FILE STRUCTURE FOR THE SYSTEM 



ARCUHENTSI 



ERROR RETURNS) 



TASKS) 



FICE STRUCTURE NAME 

BITS 

PACK ID / DRIVE PAIRS 

1 OR MORE DRIVES NOT AVAILABLE 

CANT REDEFINE BECAUSE MOUNT COUNT NOT 

FILE STRUCTURE ALREADY BEING MOUNTED 

IF ARGUMENT LIST OUT OF BOUNDS, TO ERR 

IF THE FILE STRUCTURE IS ON THE PHYSICAL DEVICE LIST 

IF N GR 3 {NEW OEFINTIONJ, TO ERR 

IF THE MOUNT COUNT NOt e, TO ERR 

IF DRIVES ARE BEING MOUNTED 

CHANGE STATE TO MOUNTED 

SET MOUNT COUNT TO 1 

EXIT 

(REDEFINITION) SET NEW FLAGS 

SET MOUNT COUNT TO t 

EXIT 

END 



IF ANY DRIVE IN THE FILE STRUCTURE IS ALREADY IN A FILE 
STRUCTURE OR DOWN. TO ERR 

SET FLAGS 

APPEND THE FILE STRUCTURE NAME TO THE PHYSICAL DEVICr LIST 

APPEND THE FILE STRUCTURE NAME TO THE DISK DEVICE LIST 

APPEND THE PACK ID'S TO THE PHYSICAL DEVICE LIST 

PUT THE PACK ID AND FILE STRUCTURE NAME IN THE TABLE 
FOR EACH DRIVE 

PUT EACH DRIVE IN BEING MOUNTED STATE 

SET THE FLAG TO REREAD THE HOME BLOCK FOR EACH DRIVE 

SET THE MOUNT COUNT TO B 

EXIT 



tOKSTR LOCKS OUT FURTHEB LOOKUP'S. ENTER'S, AND INIT'S 

AR&UMENTtI FILE STRUCTURE NAME 

tASKSl SET FLAG TO LOCK OUT FURTHER LOOKUP'S, ENTER'S AND INIT'S 

EXIT 

REMStR REMOVES A FILE STRUCTURE FROM THE SYSTEM 



AR6UMENTSI PILE STRUCTURE NAME 

tASKSl IF THE FfLE STRUCTURE DOESN'T EXIST, EXIT 

DELETE THE F!LE STRUCTURE NAME FROM ALL FILE STRUCTURE SEARCH LISTS 

DELETE THE FILE STRUCTURE NAME FROM THE PHYSICAL DEVICE LIST 

DELETE THE PAOK ID'S FROM THE PHYSICAL DEVICE LIST 

DELETE THE PACK ID'S AND FILE STRUCTURE NAME FROM THE 
TABLE FOR EACH DRIVE IN THE FJlE STRUCTURE 

PUT THE DRIVES IN A NOT IN A FILE STRUCTURE STATE 

EXIT 



FORM OF HOUNt UUOl 



MOVE 
CALL 



AiCXWO NUMWRDitOC] 
A.CSIXBIT .MOUNT,] 



OR CALL A, 



NUHWRD«THE NUMBER OF HCRDS IN THE ARGUMENT LiST 
LOC»ADORESS OF THE FIRST ARGUMENT 

THE ARGUMENT LIST HAS THE FOLLOWING FORMI 

LOG/ FILE STRUCTURE NAME 

LOC+i/ STATUS BITS 

l,0C+8/ FIRST PACK ID 

LOC+3/ FIRST DRIVE 

LOC+4/ SECOND PACK ID 

iOC*5/ SECOND DRIVE 



IF NUMHRD LESS THAN OR EOUAL TO 2, THERE ARE NO PACKS tISTCO, THIS WILL 
BE THE CASE IF THE FILE STRUCTURE IS BEING MOUNTED OR IS ALREADY MOUNTED'. 



MOUNT I CHECK BOUNDS OF ARGUMENT LIST 

IF BOUNDS ERROR. TO ERR 

IF NUMBER OF WORDS IN ARGUMENT LIST LESS OR EQUAL 2, TO NOPAKS 
GET FILE STRUCTURE NAME; 

SEARCHTHE PHYSICAL 0£»IGE=L1ST FOR THIS FILE STRUCTURE 
IF THE FILE STRCJCTORE ALREADY EXISTS* TO ERR 
DO MNTiFOR ALL DRIVES SPECIFIED 

IF THIS drive; IS INA.'FILE STRUCTURE, TO ERR 

IF THtS' DRIVE IS DO»N*^OR BEING -MOUNTED, TO ERR 

MNTil CONTINUE 

SET SINGLE/MULTlPLEACCESS AND WRITE LOCK FLAGS 

PUT THE' FILE STRUCTURE NAME ON THE PHYSiCAt, DEVICE LIST 

PUT THE' FILE STRUCIORE NAME ON THE FILE STRUCTURE SEARCH LIST 
FOR- THIS JOB 

PUT THE FILE STRUCTURE' NAME ON THE DISK DEVICE LIST 

DO MNTS'FOR ALL^PAGRi DRIVE PAIRS^ 

PUT THIS PACK ID IN THE TABLE FOR THIS DRIVE 
PUT THE FILE STRUCTURE NAME IN THE TABLE FOR THIS DRIVE 
PUT THIS'PACK ID ON THE PHYSICAL DEVICE LIST 
PUT THE DRIVE IN A BEING MOUNTED STATE' 
SET THE FLAG TO REREAD THE HOME- BLOCK BEFORE NEXT I/O 
MNt2i CONTINUE 

CLEAR THE FLAG ALLOWING ACCESS TO THE FILE STRUCTURE 

SET THE MOUNT COUNT TO- 1 

SKIP RETURN 



NOPAKS) 



MNTEDI 



MNTEQll 



MNtED2l 



SEARCH THE PHYSICAL DEVICE LIST POR THIS FILE STRUCTURE 

IF THE FILE STRUCTURE DOESN'T EXIST, TO ERR 

IF THE FIRST DRIVE OF THE FILE STRUCTURE IS NOT BEING MOUNTED, TO MNtED 

PUT ALL DRIVES IN THIS FILE STRUCTURE IN FINISHED BEING MOUNTED STATE 

ENABLE ACCESS TO THE FILE STRUCTURE 

SKIP RETURN 

IF MOUNT COUNT e B, TO MNTEDI 

IF SINGLE REQUEST, TO ERR 

IF FILE STRUCTURE IS SINGLE ACCESS, TO ERR 

IF WRITE LOCK FLAG DIFFERS FROM REQUEST, TO ERR 

to MNTED2 

SET SINGLE/MULTIPLE ACCESS FLAG 

SET WRITE LOCK FLAG 

SEARCH FILE STRUCTURE SEARCH LIST FOR THIS JOB FOR 
FILE STRUCTURE NAME 

IF ALREADY THERE. SKIP RETURN 

ADD THE FILE STRUCTURE NAME TO THE FILE STRUCTURE SEARCH LIST 
FOR THIS JOB 

ENABLE ACCESS To THE FILE STRUCTURE 

INCREMEN THE MOUNT COUNT 

CLEAR BIT SAYING MOUNT COUNT«0 

SKIP RETURN 



SAT 



3, (SLOSSARY 

DATA STRUCTURE 

SKELETON FILE STRUCTURE 

2 HOME BLOCKS 

HOME BLOCK OR VITAL STATISTICS BLOCK CONTAINS A PACK ID 
AND OTHER BASIC INFORMATION, HOME BLOCKS ARE ALWAYS 
WRITTEN IN KNOWN FIXED LOCATIONS, 

MFD 

tHE MASTER FILE DIRECTORY. A FILE NAMED 11, UFO OF THE SAME 
FORM AS ALL OTHERS CONSISTING OF RETRIEVAL INFORMATION AND 
DATA', 

STORAGE ALLOCATION FILE, THE FILE tSATn.SYS 
CONSISTING OF RETRIEVAL INFORMATION AND DATA 
DESCRIBING THE INITIAL ALLOCATION OF SPACE, 

SWAPPING FtLE 

tHE OPTIONAL FILE •SWAP*, SYS CONSISTING OF ALLOCATTED SpACE 
ONLY, CONSIDERING THE SPACE AS A FILE ALLOWS A FILE 
VERIFICATION PROGRAM TO MAKE THE CORRECT INTERPRETATION 
THAT SWAPPING SPACE IS BOTH ASSIGNED AND USED IN SOME FILE. 

MAINTENANCE AREA 

THE OPTIONAL FILE "MAINT^.SYS CONSISTS ONLY OF ALLOCATED SPACE 
ON THE BRYANT DISK AND DISK PACKS DENOTING THESE 
iLOCkS RESERVED FOR MAINTENANCE OR DIAGNOSTIC USE, 

SPARSE FILE 

A FILE WHOSE DATA IS CONTAINED ONLY IN THE SECOND BLOCK OF 
CVCRY GROUP (HOME. SYS AND SAT.SYS}, ALL OTHER FILES ARE DENSE 
SO THAT THE SECOND BLOCK THROUGH THE LAST BLOCK (EXCEPT LAST 
(iM\iP OF FtLE) CONTAIN DATA, 

compressed ufo pointer (cup) 

super cluster number and unit number foui^d only in ufd's, 
comMesscd to fit Into ib bits, 

ROOT RlB 

tHE FIRST RIB OF A FILE 

tHE RETRIEVAL POINTERS POINT TO "GROUP RIB" AND MAY ALSO POINT 

to A NEXT "CONTINUATION RIB" OF A PREVIOUS "CONTINUATION FILE" 

GROUP RIB 

THE RIB iN FRONT OF EVERY GROUP EXCEPT IF A ROOT OR CONTINUOUS RIBS 

CONTINUATION RIB 

OCCURS ONLY FOR LONG FILES WHEN ROOT RIB RUNS OUT OF ROOM TO 
HOLD RETRIEVAL POINTERS 
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REFSTR.FLO CREATEOI 14-APR-1970 20!00 PRINTEOJ a2"JUL-1970 16M8 



RFRESHI *SK "TYPE STR NAME TO REFRESH (CR IF NONE>"CCALU ASKSTR] 
If JUST CR, RETURN 

READ 1 HOME BLOCK TO GET LENGTHS OF FILES TO CREATE 

(CREATE SAT, SYS 

ALLOCATE CORE FOR READING BAT BLOCKS 

ALLOCATE CORE FOR CREATING SAT BLOCKS (StZE OF 1 DISK BLOCK) 

ALLOCATE CORE FOR SAT. SYS RIB AND HOME, SYS RIB 

SET UP RIB IN CORE FOR SAT. SYS 

SET UP RIB IN CORE FOR HOME, SYS 

60 REOUNI FOR ALL UNITS IN STR 

READ BAT BLOCKS FOR THIS UNIT CCALL RE0RUN3 

STORE NEW UNIT RETIEVAL POINTER IN SAT. SYS RIB IN CORE 

STORE NEW UNIT POINTER IN HOME. SYS RIB IN CORE 

(CREATE SAt BLOCKS 

00 MRKSAT, FOR ALL SAT BLOCKS FOR THIS UNIT 

SET TO ONES THE NON-EXISTENT RESIDUE BITS IN LAST WORDS 
[WORD SABBIT+SABTAL/36. SITS REMAINDER SABTAU/36-35 
iPLUS THE REST OF THE WORDS IN THE BL0CK3 



(MARK BAD BLOCKS 



SCN8ATI 



DO SCNBAT FOR ALL BAD REGIONS IN BAT BLOCK 

MARK OFF BAD CLUSTERS IN THIS BAD REGION IN THIS SAT 
[MAX (BEGSATi < (BAYLBN-D/UNYSPC+l) > UP TO 
MIN {BEGSAT+SVSBTL-li(<BAYLBN+BAYSKN-2)/UNYBPC+l))] 
CONTINUE 



(MARK Swapping area 



MARK OFF SWAPPING CLUSTER IN SWAPPING SPACE IN THIS SAT 
[MAX {BEGSAT,(<UNISLB-1)/UNYBPC+1)> UP TO 
MIN <BECSAT+SVSBTL-li < <UNISLB+UNYKRS»2'BLKSPK-2)/UNYBPC*t > ) ] 

IF THIS IS FiRST SAT ON THIS UNIT CBEGSAT«6I2 



/ALLOCATE HOME BLOCK GROUP 



CETBLKI 



TAKE BLOCK LBNHOM FOR THE HOME BLOCK [CALL TAKBLK] 
IF CANT GET IT, TO ERR 

STORE RETRIEVAL POINTER IN HOME, SYS RIB (IN CORE) 
SET PREVIOUS BLOCK«LBNHOM FOR FOLLOWING LOOP 
DO GETBLK, FOR BLOCKS LBNBAT.LBNISW,LB2H0M>L82BaT,LB2ISH 
TRY TO GET CURRENT BLOCK 
iF CANT GET BLOCK 

IF CURRENT SLOCK IS NOT IN SAME CLUSTER AS PREVIOUS, TO ERR 
ELSE IF CLUSTER JUST ALLOCATED IMMEDIATELY FOLLOWS PREVIOUS CLUSTER 
INCREMENT CLUSTER COUNT IN TRERIEVAL POINTER 

ELSE STORE NEW RETRIEVAL POINTER IN HOME, SYS RIB IN CORE 
END 
CONTINUE 
END 



;allocate a block for this sat in the region it represents 

take 1 block for this sat block 

store retieval pointer in sat, sys rib 

write out sat block in first block of cluster ccall omnwrt] 

write all other blocks in this cluster with ones ccall omnwrtj 

If INDEX OF THIS SAT LT SATS IN CORE FOR THIS UNIT CUNYSIC]. 
READ THIS SAT INTO MONITOR CORE CCALL REOSAT] 

MRKSATI CONTINUE 
f'EDUNII CONTINUE 

allocate space for sys ufo on 1st unit (length from home blocki 
+2 for ribs - need log blk num of 1st ufd block for rib of files he create) 

jallocate ribs for sat. sys and home. sys 

Take block for ist sat.sys rib on ist unit ccall takblk] 

STORE retrieval POINTER IN SAT, SYS RIB IN CORE 
REMEMBER LOGICAL BLOCK NUMBER OF 1ST SAT.SYS RIB 

Take i slock for 2nd sat.svs rib on last unit 

STORE RETRIEVAL POINTER IN SAT. SYS RIB IN CORE 
WRITE FIRST AND LAST RIB CCALL OMNWRT] 

TAKE 1 BLOCK FOR 1ST HOME, SYS RIB ON IST UNIT CCALL TAKBUK3 

STORE RETRIEVAL POINTER IN HOME, SYS RIB IN CORE 

REMEMBER LOGICAL BLOCK NUMBER OF 1ST HOHE.SyS RIB 

TAKE 1 BLOCK FOR 2N0 HOME, SYS RIB ON LAST UNIT CCALL TAKBLK] 

WRITE 1ST AND 2N0 RIB FOR HQME.SYS CCALL OMNWRT] 

HERO OUT ALL SLOCKS IN HOME, SYS WHICH ARE NOT DATA (DUE TO LARGE CLUSTER SIZE) 



ALLOCATE RIB FOR MAINT.SYS 

bo MANLOP, FOR ALL UNITS IN THIS STR 

ALLOCATE SPACE FOR MAINT.SYS (DEVICE OEPENDE^IT) ON THIS UNIT 
MANLOPI CONTINUE 

ALLOCATE 2ND RIB FOR MAINT.SYS 

STORE CFPi AND WRITE RIBS CSET, RIPNDL « RIPNCN] 

ALLOCATE RIB ♦ SPACE (CRSBKN) + RIB FOR CRASH . SAVCCQNSECUTIVE ) 

STORE NEW LOC OF CRASH, SAV <FIRST DATA BLOCK R'THER THAN RIB) FOR HOME BLOCKCHOMCRS] 

WRITE ZEROS IN ALL DATA BLOCKS 

ALLOCATE RIB ♦ SPACE ISNPBKN) + RIB FOR SNAP, SYS (CONSECUTIVE) 
STORE NEW LOC OF SNAP.SPS FOR HOME BLOCK CH0MSMP3 
WRITE ZEROS IN ALL DATA BLOCKS 
STORE CFP AND WRITE RIBS 

ALLOCATE RIB + SPACE (RCVBKN) + RIB (CONSECUTIVE) 
STORE NEW LOC OF RECOV.SYS FOR HOME BLOCK CHOMRCV] 
WRITE ZEROS IN ALL DATA BLOCKS 
STORE CFP ANO WRITE RIBS 

ALLOCATE SPACE FOR 1ST SWAP. SYS RIB 
WRITE ZEROS IN UNUSED BLOCKS IN FIRST CLUSTER 
DO SCNUNIi FOR ALL UNITS IN STR 
IF THIS UNIT HAS SWAP SPACE 

STORE NEW UNIT RETRIEVAL POINTER IN RIB 
STORE NEW RETRIEVAL POINTER(S) 
END 
SCNUNII CONTINUE 

ALLOCATE SPACE FOR 2ND SWAP. SYS RIB 

WRITE RIBS AND STORE CFP (MARK RIB NOT DEL OR CHNG NAM CRIPNOLtRIPNCN] > 

ALLOCATE SPACE FOR 1ST BADBLK.SYS RIB 

WRIT ZEROS IN UNUSED BLOCKS IN FIRST CLUSTER 

00 SCNSTK, FOR ALL UNITS IN THIS STR CSTRUNI-UNISTR] 

CONVERT SAO REGION TO ONE OR MORE RETRIEVAL POINTERS AND STORE IN RIB 

SCNStKI CONTINUE 

ALLOCATE SPACE FOR 2ND BADBLK.SYS RIB 

WRtTE RIBS AND STORE CFP (SET RIPNOL AND RIPNCN BITS) 



ALLOCATE SPACE FOR RIB ♦ MFD + RIB (NEED LOG BUK NUM OF 

ISt DATA BLOCK OF MFD TO STORE IN BIB OF UrO'S} 
WRITE RIBS AND DATA FOR SYS UFO CENTRIES FOR FILES JUST GENERATEDf FILUJ 

ALLOCATE SPACE FOR RIB + SiS.UFD CPRUFSH BLOCKSJ + RIB 
STORE NAME. EXT, AND CFp IN MFD 
WRITE RIBS AND HERDS FOR DATA 

WRITE RIBS AND DATA FOR MFD CENTRIES FOR UFD'S JUST CREATED! 
REMEMBER 1ST RETRIEVAL POINTER OF MFD FOR HOME BLOCK 

00 SCNUNl, F0« ALL UNITS IN STR 
READ HOME SLOCKS (CALL REORUN) 

UPDATE LOGICAL BLOCK OF 1ST RIB OF SYSTEM FILES CHOMSaT,HOMSWP,HOMMNT, 
WRITE HOME BLOCKS 
SCNUN7I CONTINUE 

STORE SYSPPN IN REFLAG 

REWRITE SAT BLOCKS WHICH HAVE CHANGED CCALL WTSATS3 

EXIT 
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2, bVERVIEM 



FILTST IS A MACRO SOURCE PROGRAM WHICH DEFINES A MACRO LEVEL 
LANGUAGE INTENDED AS A CONVENIENT MEDIUM IN MHICH TO WRITE 
PROCEDURES WHICH EXERCISE AND TEST THE FILE HANDLING 
CAPABILITIES OF THE PDP-IB TIME-SHARING MONITOR, IN ORDER 
THAT THIS MACHO LANGUAGE POSSESS THE GENERALITY AND FLEXI- 
BILITY OF THE STANDARD USER MODE TECHNIQUES FOR DOING FILE 
I/O AT ASSEMBLY LEVELf THE LANGUAGE IS NECESSARILY QUITE 
CLOSE TO STANDARD USER-MODE I/O. AND IS INTENDED TO BE USED BY 
SOMEONE THOROUGHLY FAMILIAR WITH THE STRUCTURE AND CALLING 
SEQUENCES OF THE STANDARD UUOS. HOWEVER, IT IS INTENDED TO 
RELIEVE THE PROGRAMMER OF ATTENTION TO BIT AND WORD LEVEL 
DETAIL AND TO PERMIT HIM TO SPECIFY REASONABLY COMPLEX DISK 
OPERATIONS WITH SIMPLICITY AND COMPACTNESS AT BOTH SOURCE 
AND OBJECT LEVELS. 

fatST IS NOT A "CONDITIONAL LANGUAGE, THAT IS, IT IS NOT 
INTENDED THAT FILE OPERATIONS BE "TRIED TO SEE WHAT HAPPENS", 
WITH SUBSEQUENT ACTION DEPENDING UPON A PREVIOUS RESULT, 
RAtHERi IT IS INTENDED THAT THE USER WHO PREPARES ANY T£ST 
PROCEDURE HAVE AN UNDERSTANDING OF EXACTLY WHAT SHOULD HAPPEN 
WHEN THE PROCEDURE IS EXECUTED, FILTST WILL ATTEMPT TO 
PROVIDE DIAGNOSTIC INFORMATION WHENEVER A RESULT IS CONTRARY 
TO AN INDICATED EXPECTATION, 

tHE USE OF FILTST TYPICALLY INVOLVES THE PREPARATION OF AN 
AUXILIARY TEXT FILE IN THE FILTST LANGUAGE CONSISTING OF 
A NUMBER OP INDEPENDENT DEFINITIONS OF TEST PROCEDURES (WHICH 
Hay call EACH other recursively to ANY DEPTH) AND A LIST OF 
WHICH OF THESE PROCEDURES ARE TO BE EXECUTED AND IN WHAT 
ORDER, tHIS AUXILIARY FILE IS THEN ASSEMBLED WITH PILTST 
AND tHE RESULTING SINGLY BINARY FILE IS LOADED AND EXECUTED, 
fHE RUNNING TO COMPLETION OF THIS EXECUTION WITH NO UNUSUAL 
OUtPUT, INDICATES THAT ALL OF THE TESTS SPECIFIED IN THE 
AUXILIARY FILE RAN WITH SPECIFIED EXPECTATIONS BEING MET, 
ANY ERROR CONDITION, UNEXPECTED RETURN PROM A UUO, OR 
UNEXPECTED VALUE RETURNED BY THE MONITOR WILL RESULT IN AN 
JERROR MESSAGE AT THE CONSOLE, THE USER IS THEN NEE TO 
PROCCDE FROH THE ERROR CONDITION, IGNORING IT, OA ATTEMPT TO 
ANALYZE tHE PROBLEM BEFORE CONTINUING, 
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(2, CONT'D) 



WHEN SOME ERROR DOES OCCUR. USUALLY BECAUSE SOME EXPECTATION 
HAS NOT BEEN MET, THE USER IS FACED WITH THE PROBLEM OF 
DETERMINING WHAT WENT WRONG, UNLESS THE TEST HAS RUN SUCCESS- 
FULLY WITH THE SAME MONITOR BEFOREi THE FIRST QUESTION IS 
LIKELY TO 8EI "HAVE I DISCOVERED A BUG IN THE DISK SERVICE, 
OR IS THERE A BUG IN BY TEST PROCEDURE?" UNFORTUNATELY, FILTST 
is HARD PRESSED TO DETERMINE THE DIFFERENCE AND THE USER MUST 
RELY UPON ANALYSIS OF HIS PROCEDURES IN THE LIGHT OF WHAt 
HAPPENED. IT IS FILTST'S MAIN ORDER OF BUSINESS TO 9H0H THE USER 
WHAT DID HAPPEN, THE ERROR TRACE PRINTED BY FILTST FOLLOWING 
ANY ERROR MESSAGE WILL DISCLOSE THE EXACT PATH TAKEN THROUGH 
THE USERS NESTED PROCEDURES AND AT JUST WHICH STEP OF WHICH 
PROCEDURE The error OCCURRED, IT ALSO SHOWS THE- NUMBER OF 
TIMES EACH PROCEDURE HAS SEEN CALLED SUCCESSFULLY (MORE 
DETAIL BELOW), IT IS HOPED THAT THIS INFORMATION ANO A 
SOURCE LISTING OF THE AUXILIARY FILE OF PROCEDURE DEFINITIONS 
WILL BE SUFFICIENT IN MANY CASES FOR COMPLETE ANALYSIS OF THE 
PROBLEM, FOR THOSE CASES IN WHICH It IS NOT SUFFICIENT, 
A COPY OF DOT IS LOADED WITH FILTST, ENOUGH OF FILTST'S 
INTERNAL STRUCTURE, USE OF ACS ETC. IS PRESENTED BELO'W SO 
THAT DOT CAN BE USED EFFECTIVELY TO DISCOVER MORE ABOUT THE 
CAUSE OF ANY ERROR MESSAGE, 

MORE GENERALLY, THE OPERATION OF "PREPARING THE AUXILIARY 
FILE OF TEST PROCEDURES" IS LIKELY TO B£ THE EXPANDING OF 
ONE OR MORE GROWING PROCEDURE FILES, IT IS INTENDED THAT 
VARIOUS OPERATING VERSIONS OF FILTST, EACH CONTAINING ITS 
OWN SUB SET OF PROCEDURES, BE SAVED IN CORE IMAGE FORM AFTER 
BEING DEBUGGED, TO BE USED REPEATEDLY TO TEST THE CONTINUED 
INTEGRITY OF THE MONITOR'S DISK SERVICE WHENEVER CHANCES ARE 
MADE TO IT, 
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.3, WRITING TEST PROCEDURES 



TEST PROCEDURES IN THE FILTST LANGUAGE ARE USUALLY SHORT AND 
QUITE COMPACT, THEY CONSIST MAINLY OF MACRO CALLS, SOME OF 
WHICH TAKE ONE OR MORE SIMPLE ARGUMENTS, UPON RARE OCCASIONS 
IT IS ALSO CONVENIENT TO INCLUDE A FEW BASIC PDP-10 INSTRUC- 
TIONS WHICH REFERENCE A SMALL SET OF ACCUMULATORS KNOHN TO 
BE AVAILABLE AND A FEW ADDRESSES WITH PREDICTABLE MNEMONICS, 

to THE EXTENT THAT PROCEDURES ARE COMPACT, THEY ARE VERY EASY 
TO WRITEl UNFORTUNATELY, THEY ARE CORRESPONDINGLY DIFFICULT 
TO UNDERSTAND WITH RESPECT TO OVERALL INTENT UNLESS GENEROUSLY 
COMMENTED, A RECOMMENDED CONVENTION WHICH RESULTS IN A CLEAN 
CREF LISTING FOR LATER USE DURING ERROR ANALYSIS, IS THAT 
COMMENTS APPEAR IN BLOCKS PRECEDING PROCEDURE DEFINITIONS 
RATHER THAN OH INDIVIDUAL SOURCE LINES WjTHIN THE PROCEDURES. 
{COMMENTS ON LINES WITH MACRO CALLS ARE DELETED DURING ASSEMBLY, 
THIS IS TRUE BECAUSE IT IS FELT THAT A SOURCE-LIKE LISTING CONT- 
AINING ONLY MACRO CALLS AND ARGUMENTS IS A MUCH MORE CONVENIENT 
TOOL FOR DEBUGGING THAN A LISTING IN WHICH MACRO EXPANSIONS 
ARE SHOWN. IH FACT SOME AMOUNT OF TROUBLE IS TAKEN TO AVOID 
ALL UNNECESSARY OUTPUT IN CREF LISTINGS,) 
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3.1 FILTST DATA BASE 



SOME MONITOR UUO'S (EG, OPEN, UOOKUP, SEARCH. ENTER, RENAHE) 
TAKE ARGUMENTS ANO RETURN VALUES IN DATA BLOCKS WITHIN A JOBS 
LOW SEGMENT. A LARGE PART OF THE INTRICACY OF DOING DISK 
!/0 IN USER MODE INVOLVES ESTABLISHING, SETTING, TESTING ANO 
CLEARING THE RIGHT PARTS OF THESE UUO DATA BLOCKS, MANY OF 
THE FILTST MACROS EXIST FOR THE PURPOSE OF MAKINS THIS JOB 
EASY. AS A COMPROMISE BETWEEN SIMPLICITY AND SIZE, THE 
FOLLOWING IMPLEMENTATION DECISIONS WERE REACHEDl 

i, THERE MILL BE A MAXIMUM NUMBER OF SOFTWARE CHANNELS WHICH 
ANY SINGLE JOB RUNNING FILTST CAN USE SIMULTANEOUSLY! 
THIS PARAMETER HAS BEEN ARBITRARILY SET AT FIVE (5> 
"INITIALLY, 

2. ALLOCATION OF CORE TO UUO DATA BLOCKS WILL NOT BE OYNAMICJ 
RATHER, SUFFICIENT DATA SPACE FOR THE MAXIMUM NUMBER OF 
SIMULTANEOUS CHANNELS WILL BE GENERATED AT ASSEMBLY TIME. 

FOR EACH POTENTIALLY ACTIVE CHANNEL, THERE EXISTS IN FIlTST'8 
LOW SEGMENT A BLOCK OF LOCATION CONSISTING OF THREE WORDS FOR 
USE WITH THE OPEN UUO. A SINGLE EXPANDABLE BLOCK (CURRENTLY 
SET AT TEN WORDS) FOR USE WITH ALL EXTENDED LOOKUP « SEARCH • 
ENTER - RENAME, UUOS. AND THREE OR MORE ADDITIONAL PARAMETER 
WORDS (TO BE EXPLAINED BELOW), THE GENERATION OF UNEMDNICS 
AND MACROS FOR EACH OF THE WORDS IN tHIS "PER-CHANNEL" DATA 
BASE IS CONTROLLED BY THE DEFINITION OF THE ARCS MACRO TO 
BE FOUND ON PAGE 4 OF A LISTING OF FILTST, IT IS INTENDED THAT 
ONLY THE DEFINITION OF THIS ARCS MACRO NEED BE CHANGED IN 
ORDER TO REARRANGE OR EXPAND THE ARRAYS OF ARGUMENTS AND 
VALUES WHICH ACCOMPANY THE UUOS, IN FACT, THE ONLY SOURCE 
LEVEL DIFFERENCE BETWEEN THE VERSION OF FILTST FOR LEVEL C 
DISK SERVICE AND THAT FOR LEVEL DISK SERVICE, IS A REAR' 
HANGEMENT OF FIVE ENTRIES (ENTRIES FOUR THROUGH EIGHT) IN 
THE ARCS MACRO. 
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3,2 THE SETXXX AND SELXXX MACROS 

rOfl EACH WORD IN THE "PER-CHANNEL" DATA BASEi THERE IS A MACRO 
OF THE FORM SETXXX WHERE THE LAST THREE CHARACTERS MATCH SOME 
THREE CHARACTER MNEMONIC WITHIN THE DEFHTION OF ARGS, BY 
MEANS OF EACH OF THESE MACROS, THE CORRESPONDING LOCATION 
IN THE DATA BASE CAN BE "SET". IN ADDITION TO ONE DATA BLOCK 
FOR EACH CHANNELi THERE IS ONE "JOB STANDARD" DAT* BLOCK WHICH 
is INTENDED TO CONTAIN DEFAULT ARGUMENTS TO BE USED ON ANY 
USER CHANNEL WHENEVER A REQUIRED ARGUMENT HAS NOT SEEN PRE- 
VIOUSLY SET, THE VARIOUS ENTRIES IN THIS "JOB STANDARD" OAT* 
BLOCK ARE SET BY MEANS OF SELXXX MACROS, FOR EVERY SETXXX 
MACROi THERE IS A CORRESPONDING SELXXX "SELECT" MACRO, 
SELXXX MACROS ARE CHANNEL INDEPENDENT. WHILE SETXXX MACROS 
ALWAYS APPLY TO SOME SPECIFIC "CURRENT" CHANNEL <AS DESCRIBED 
BELOW), 

3,2,1 MACRO ARGUMENTS 

WITH CERTAIN SPECIAL EXCEPTIONS, MACRO ARGUMENTS ARE 
TYPICALLY EITHER DECIMAL NUMBERS (IMMEDIATE MODE) OR CHARACTERS 
WHICH SPECIFY AN ADDRESS WHOSE CONTENTS COMPRISES THE 
ARGUMENT, IN THE CASE OF SETXXX AND SELXXX MACROS, OBSER- 
VATION OF THE ARGS DEFINITION AND THE COMMENTS WHICH PRECEDE 
iT WILL REVEAL WHICH OF THE MACROS ARE IMMEDIATE AND WHICH 
TAKE ADDRESS, OR SPECIAL ARGUMENTS, AS A COMPROMISE BETWEEN 
OENERALITY AND SthPLE USEFULNESS, THOSE DATA BASE ENTRIES 
WHICH REQUIRE ADDRESS ARGUMENTS <I,E,, THOSE OF MORE THAN 
is BITS) ARE RESTRICTED TO A SET OF CHOICES GIVEN IN TABLES 
ON PACE 8 OF FILtST, BY CONVENTION, A CHOICE IS MADE BY 
iSIVING AS AN ARGUMENT TO A SETXXX OR SELXXX MACRO, JUST 
tHE CHARACTERS FOLLOWING THE PERIOD IN LOCATION NAMES 
SHOWN IN THESE TABLES, THE TABLES CAN CERTAINLY BE EXPANDED. 
MODIFIED WITH DOT, OR PERHAPS (AS A POTENTIAL FUTURE FEATURE) 
SET CONVERSATIONALLY IN AN INITIALIZATION DIALOGUE. 
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3,3 THE SELCHN MACRO AND EXAMPLES 



WITH THE EXCEPTION OF THE SELXXX MACROS WHICH MODIFY THE 
SINGLE CHANNEL INDEPENDENT DATA BASE, AND THE EXPECT MACRO 
«T0 BE DESCRIBED BELOW) ALL MACROS PERTAIN TO SOME S0FTH4RE 
CHANNEL. WHICH CHANNEL A MACRO PERTAINS TO IS NOT SPECIFIED 
IN THE MACRO CALL. BUT RATHER IS DETERMINED BY THE MOST RE- 
CENTLY EXECUTED SELCHN ("SELECT CHANNEL") MACRO, THIS 18 SO 
THAT WHOLE PROCEDURES MAY BE WRITTEN INDEPENDENT OF A 
SOFTWARE CHANNEL NUMBER AND THEN CALLED AFTER AN APPROPRIATE 
SELCHN MACRO, SELCHN IS A SPECIAL MACRO WHICH "SELECTS" 
THE CHANNEL TO WHICH ALL SUBSEQUENT MACROS (AND THE UUOS 
THEY. STIMULATE) WILL APPLY UNTIL THE EXECUTION OF ANOTHEB 
SELCHN MACHO. SOME EXAMPLES MAY CLARIFY THE ABOVE DISCUSSION. 

MACRO SEQUENCE 

SELNAM A SELECT FILENAME FILTSA AS THE CHANNEL 
INDEPENDENT DEFAULT FILENAME IN THE 
"JOB STANDARD" DATA BASE <6TH WORD) 
SELCHNZ SET STRUCTURE NAME TO OPA0 IN OAtA 
SETSTR AS BASE FOR CHANNEL 2 <2ND HOROJ 
SETDIR SET THE DIRECTORY NAME TO ZERO (TO 
USE CURRENT PJ, PG) STILL IN DAT* 
BASE FOR CHANNEL 2, 
<2N0 WORD IN LOOKUP ETC, BLOCK « OR 
5TH WORD IN CHANNEL DATA BASE) 
SELCHN SET THE NUMBER OF ARGUHENTS PASSED 

SETaRG 4 IN SUBSEQUENT LOOKUP ETC, UUOS TO 4 
IN CHANNEL DATA BASE (4TH MORD) 

IT CAN BE SEEN THAT BY MEANS OF SETXXX MACROS FOLLOWING 
SOME SELCHN MACRO, ANY ENTRY IN THE UUO DATA ARRAYS QAH BE SET 
FOR ANY CHANNEL. NOT ALL OF THE ENTRIES DEFINED IN THE ARCS 
MACRO HAVE BEEN EXPLAINED SUFFICIENTLY AT THIS POINTI * 
COMPLETE DESCRIPTION OF EACH APPEARS IN THE LIST OF MACROS IN 
APPENDIX I, ALSO, THE PURPOSE OF THE CHANNEL INDEPENDENT 
SELXXX MACROS HAS NOT YET BEEN SUFFICIENTLY EXPLAINED, READ 
ON, 
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3,4 OTHER DATA BASE MACROS 



IN ADDITION TO THE SETXXX MACROS TOR SETTING ENTRIES IN THE 
"PER CHANNEL" DATA BASE, AND SELXXX MACROS FOR "SEUECTING" 
ENTRIES IN THE "JOS STANDARD" DATA BASE. FIVE OTHER MACROS 
ARE USEFUL IN SETTING DATA BASE ENTRIESi 

OLRVAL WILL CLEAR THE ENTIRE DATA BASE FOR A PARTICULAR 
CHANNEL (DEPENDING AS USUAL UPON THE MOST RECENT SELCHN 
MACRO). IF AN ARGUMENT IS SUPPLIED TO CLRVALi IT IS A DECIMAL 
NUMBER SPECIFYING WHERE THE CLEARING OPERATION IS TO BEGIN. 
FOR EXAMPLE, CLRVAL 7 WILL CLEAR ALL OF THE EXTENDED ARGUMENTS 
iN THE CURRENT CHANNEL LKP-ENT'REN BLOCK, <I,E,i IT WJLL 
NOT CLEAR THE FIRST 7 WORDS - THREE IN THE OPEN BLOCK AND 
fOUR IN THE LKP-ENT-REN BLOCK. ANY SINGLE DATA BASE WORD CAN 
BE CL.EARED BY GIVING AS AN ARGUMENT TO THE APPROPRIATE 
SETXXX MACROi NO MATTER WHAT TYPE OF ARGUMENT THE PARTICULAR 
MACRO USUALLY TAKES, 

RSTEXT AND RSTPRT WILL CLEAR ALL BUT THE EXTENSION AND PRO- 
TECTION FIELDS RESPECTIVELY IN THE CORRESPONDING WORDS IN 
THE CURRENT CHANNEL DATA BASE, THAT IS, THEY WILL CLEAR 
ANY VALUES THE MONITOR MAY HAVE RETURNED IN OTHER FIELDS 
iN THESE WORDS, 

THE FORSET MACRO IS USED TO "FORCE THE SETTING" OF SPECIFIC 
WORDS IN THE CURRENT CHANNEL DATA BASE USING THE CQRRES. 
PONDING WORDS IN THE ^OB STANDARD DATA BASE AS A SOURCE, THE 
MACRO TAKES AN ARBITRARY LENGTH STRING OF ARGUMENTS ENCLOSED 
iN ANGLE BRACKETS AND SEPARATED BY COMMAS] EACH ARGUMENT IS 
ONE DP THE THREE CHARACTER MNEMONICS FOUND IN THE ARCS MACRO, 
fOR EXAMPLE, FORSET <ARC, OIR> WILL FORCE THE FIRST TWO WORDS 
|N TflE LKP-ENT-REN BLOCK FOR THE CURRENT CHANNEL TO BE SET 
PROH THE JOB STANDARD DATA BASE WHICH WOULD PRESUMABLY HAVE 
BEEN SET PREVIOUSLY BY SELARC AND SELDIR MACROS, THE INTEN- 
flON OF tHIS MECHANISM IS THAT PROCEDURES MAY BE WRITTEN 
INDEPENDENT OF PARTICULAR UFDS, FILENAMES, STRUCTURES, ETC., 
AND fHEN CALLED (FROM WITHIN SOME OTHER PROCEDURE) AFTER AP- 
PROPRIATE SELXXX MACROS. 
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(3.4 CONT'D) 



FINALLY (FOR THIS SECTION). THE INSURE MACRO IS IDENTICAL 
TO FORSET, EXCEPT THAT THE SPECIFIED DATA BASE ARGUMENTS ARE 
SET ONLY IF THEY HAVE NOT ALREADY BEEN SET (BY A SETXXX, 
FORSET OR INSURE MACRO) SINCE THE MOST RECENT RELEASE UUO 
ON THE CURRENT CHANNEL, A RANDOM FACT WHICH BELONGS FURTHER 
ALONG IN THIS OOCUf ENTATION BUT MIGHT CLARIFY THE USE OF THE 
INSURE MACRO IS THAT WHENEVER AN OPEN UUO IS EXECUTED FOR A 
PARTICULAR CHANNEL. FILTST DOES AN AUTOMATIC 

INSURE <MOD, STR, BUF> 

AND BEFORE ANY UUO WHICH REFERENCES THE LKP-ENTvREN BLOCK, 
FILTST DOES AN AUTOMATIC 

INSURE <ARG, DIR, NAM. EXT, PRT> 

(THIS DOES NOT IMPLY THAT THE USER CANNOT SET THE NUMBER OF 
ARGUMENTS For LKP-ENT-REN UUOS LESS THAN FOUR). 

3.5 SPECIFYING EXPECTATIONS 

SO FAR. THE ONLY MACROS DISCUSSED HAVE BEEN FOR MODIFYING 
AN IN CORE DATA BASE) NONE HAVE RESULTED IN INVOLVING THE 
MONITOR, FILTST PROCEDURES ARE INTENDED TO TAKE TWO PREP- 
ARATORY ACTIONS BEFORE EXECUTING ANY MACROS WHICH RESULT 
IN UUOS, THE FIRST OF THESE ACTIONS IS THE PREPARATION (JF 
THE CHANNEL DATA BASE AS DESCRIBED ABOVEl THE SECOND IS THE 
PREDICTING OF EXPECTED RESULTS, A SINGLE MACRO, CALLED EXPECT, 
EXISTS FOR THIS PURPOSE. 

EXPECT TAKES TWO ARGUMENTS EITHER OF WHICH MAY BE MISSJNG, 
THE FIRST OF THESE SPECIFIES RETURN EXPECTATIONS FOR ANY 
SUBSEQUENT UUOS WHICH HAVE MORE THAN ONE RETURN, THE ARGU- 
MENT MAY BE A SINGLE CHARACTER FROM THE SET GIVEN BELOW, 
OR A DECIMAL NUMBER, IT IS INTERPRETED AS FOLLOWSl 

ARGUMENT INTERPRETATION 

X EITHER UUO RETURN ACCEPTABLE 

N NORMAL (SKIP) RETURN EXPECTED 

E ERROR (FIRST) RETURN EXPECTED BUT 

ANY ERROR CODE IS ACCEPTABLE 
<NUMBER> ERROR (FIRST) RETURN EXPECTED ANO 
ERROR CODE MUST BE <NUM8ER> 

THIS FIRST ARGUMENT TO EXPECT IS RELEVANT ONLY FOR SUBSEQUENT 
UUOS OF TWO RETURNS, SINGLE RETURN UUOS DO NOT REQUIRE THIS 
FORM OF EXPECTATION PREDICTION. 
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(3.5 CONT'D) 



THE SECOND ARGUMENT TO EXPECT IS RELEVANT FOR ALU SUBSEQUENT 
UUOS, IT SPECIFIES THE EXPECTED STATES OF THE FIVE STATUS BITS 
RETURNED IN BIT POSITIONS IB - 2Z OF THE GETSTS UUO, UN- 
LESS ERROR CHECKING IS SUPPRESSED FOR SOME REASON (AS IT 
USUALLY IS IN CASES WHERE A SINGLE PROCEDURE MACRO REQUIRES 
THE EXECUTION OF MORE THAN ONE UUOJi A GETSTS IS DONE AFTER 
EVERY OTHER UUO, AND THE FOUR ERROR BITS PLUS THE ENO-OF- 
FILE BIT ARE CHECKED AGAINST EXPECTATIONS, 

tHE MACRO ARGUMENT MUST CONSIST OF STRING OF FIVE CHAR- 
ACTERS, EACH OF WHICH MUST BE EITHER Z, 1 OR X, EACH CHARACTER 
CORRESPONDS TO ONE OF THE FIVE STATUS BITS (FROM LEFT TO 
RiGHf) WHERE 2 AND 1 SPECIFY THAT THE BIT MUST BE EITHER A 
HERO OH A ONE. AND X SPECIFIES THAT EITHER ZERO OR ONE IS 
ACCEPTABLE FOR THAT BIT. 

NOTICE THAT THE EXPECT MACRO IS CHANNEL INDEPENDENT, AND 
SPECIFIES EXPECTATION FOR ALL SUBSEQUENT UUOS, NO MATTER 
WHAT CHANNEL THEY ARE EXECUTED ON, IT IS INTENDED THAT EXPECT 
MACROS BE EXECUTED AS OFTEN AS ECPECTATIONS CHANCE. DURING 
MOST PARTS OF MOST PROCEDURES, THE EXPECTATIONS ARE LIKLY TO BE 

EXPECT N, 00000 

ONE SUCH MACRO IS SUFFICIENT UNTIL SOME ERROR RETURN OR 
ERROR BIT IS TO BE EXPECTED, IF EITHER ARGUMENT TO AN EXPECT 
MACRO IS MISSING (I.E. BLANK), THE PREVIOUS EXPECTATIONS FOR 
THAT ARGUMENT ARE NOT ALTERED, 
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3,6 THE EXECUTE MACROS 



ONCE THE DATA BASE FOR A PARTICULAR CHANNEL AND THE APPROPRIATE 
EXPECTATIONS HAVE BEEN ESTABLISHED BY MEANS OF SETXXX {QR 
SELXXX AND FORSET) AND EXPECT MACROSi IT IS THEN REASONABLE 
TO PROVOKE ACTION BY MEANS OF THE XCTXXX MACROS, WITH THE 
EXCEPTION OF INPUT AND OUTPUT WHICH ARE DESCRIBED IN DETAIL 
BELOW, THERE IS ONE SIMPLE XCT MACRO FOR EACH OF THE POS- 
SIBLE UUOS, FOR THE UUOS OPEN (iNIT IS NEVER USED), LOOKUP 
ENTER, RENAME, SEARCH, SEEK AND RELEASE, THE CORRESPONDING 
MACROS ARE XCTOPN, XCTLKP, XCTENT, XCTREN, XCTSRC, 
XCTSEK, AND XCTRLS. NONE OF THESE MACROS TAKE ARGUMENTS 
SINCE THE PROPER CHANNEL NUMBER IS DETERMINED BY THE MOST 
RECENT SELCHN MACRO, AND ALL OTHER PARAMETERS HAVE BEEN DETER- 
MlNEi) BY PREVIOUS PREPARATORY MACROS (AS DESCRIBED IN THE 
PARAGRAPHS ABOVE). 

THE UUOS USETO, USETI AND CLOSE ARE ACCOMPLISHED BY XCTSTO, 
XCTSTI AND XCTCLS MACROS. THESE THREE MACROS MAY EACH 
TAKE A SINGLE NUMERIC ARGUMENT (INTERPRETED AS DtCIMADi TO 
SPECIFY THE RELATIVE BLOCK NUMBERS IN XCTSTO AND XCTSTI MACROS, 
AND to OPTIONALLY SPECIFY THE ADDRESS FIELD OF THE CLOSE UUO 
(WHEREBY ONE SIDE OR THE OTHER OF A BI-DIRECTIONAU OPERATION 
CAN BE CLOSED). 

EACH OF THESE XCTXXX MACROS GENERATES A PUSHT CALL TO A 
ROUTINE WHICH SETS UP AND EXECUTES FROM WITHIN THE ACS 
THE PROPER UUO FOR THE CURRENT CHANNEL, THEN PERFORMS ALL 
EXPECTATION CHECKING WITH ERROR MESSAGES AND DIAGNOSTIC 
OPERATIONS INVOKED AS APPROPRIATE AND FINALLY, TURNS OFF ANY 
STATUS BITS WHICH COME ON FOR THAT CHANNEL, AND RETURNS TO 
THE NEXT MACRO IN THE CURRENT PROCEDURE, 
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S,7 READ AND WRITE OPERATIONS 



FOUR MACROS EXIST TO ALLOW EASY SPECIFICATION OF INPUT AND 
OUTPUT OPERATIONS. EACH OF THESE MACROS CAN RESULT JN AN 
ARBITRARY NUMBER OF INPUT OR OUTPUT UUOS BEING EXECUTED, 
THE FOUR MACROS ARE 

REDNXT N, P - "READ NEXT" N WORDS) EXPECT DATA 

PATTERN P, 
WRTNXT N, P - "WRITE NEXT" N WORDS IN DATA PATTERN P. 
REDSFC N. e, P ^ "READ SPECIFIC" N WORDS STARTING WITH 

FIRST WORD OF RELATIVE BLOCK B) 

EXPECT DATA PATTERN P. 
WRTSPC N, B, P - "WRITE SPECIFIC" N WORDS STARTING 

WITH FIRST WORD OF RELATIVE 8WCK B. 

IN DATA PATTERN P, 

tHE ji«RU«£NT N IS GIVEN IN WORDS RATHER THAN BiOOKS SO THAT 
PARTIAL tLOCKS MAY BE READ AND WRITTEN, THE ARGUMENT B IS 
A tOCCillJkL AS USUAL) RELATIVE BLOCK NUMBER IN THE CURRENT 
tliS; THE DATA PATTERN IS ALSO A DECIMAL ARGUMENT WHICH 
SHOULD BE A NUMBER BETWEEN AND 255. THIS iS BECAUSE THE 
ARGUMENT SUPPLIED IS TRUNCATED TO B BITS, AND THEN REPRODUCED 
^OUR TIMES IN A 36 BIT WORD, THE RESULTING WORD IS WRITTEN 
jOR EXPECTED) IN A PARTICULAR POSITION IN EACH BLOCK OF THE 
FILE BEING WRITTEN OR READ, A DATA PATTERN ARGUMENT OF B IS 
A SPECIAL CASE SPECIFYING THAT DATA PATTERNS ARE NOT TO BE 
CHECKED UPON INPUT. 

ft It SOMETIMES USEFUL FOR SOME OR ALL OF THE ARGUMENTS TO 
RED OR MRT MACROS TO BE MISSING, TO ALLOW FOR THIS POS, 
SIBILItY, THREE ADDITIONAL WORDS ARE PART OF EACH CHANNEl. 
JJAtA BASE (AND THE JOB STANDARD DATA BASE), THEY ARE THE 
tAST_THREE ENTRIES IN THE ARCS MACRO {NAMELVI NHB. XFW, 
AND PAT) AND STAND FOR "NEXT RELATIVE BLOCK" (TO READ OR WRITE), 
"TRANSFER WORDS" (t.E, NUMBER OF WORDS TO READ OR WRITE), 
ANO "DATA PATTERN," THESE LOCATIONS ARt SET IN THE USUAL 
MANNER WITH SETXXX (AND SELXXX) MACROS AND ONE REFERENCED BY 
tHI RED ANO WRT MACROS WHENEVER (ONLY IF) THE CORRESPONDING 
ARGUMENTS HERE NOT SUPPLIED, FOR EXAMPLES, SOME OF THE MANY 
EQUIVALENT MACRO SEQUENCES TO ACCOMPLISH THE WRITING OF 
BLOCKS 3. 4, AND 5 OF A FILE IN DATA PATTERN 2 MIGHT BEl 

WRTSPC 3»BL, 3, 2 

(OR) 

SETNRB 3 

SETPAT 2 

WRTSPC 3»BL 

(OR) 
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(3.7 CONT'D) 



SeiNRS 3 

SELXrM 3*BL 

SELPAT 2 

FORSET <NRB, XFW, PAT> 

WRTSPC 

(OR) 

SETPAT 2 

XCTSTO 3 

WRTNXT 3»BU 

<ETC.) 

THE MECHANISM BY WHICH I/O IS ACCOHPISHEQ DEPENDS UPON 
THE DATA MODE, PRIOR TO ANY XCTOPN, THE DATA MODE MUST HAVE 
BEEN SELECTED BY A SETMQD (OR SELMOD) MACRO, MOO IS ONE OF 
THE ENTRIES DECLARED IN THE ARCS MACRO TO HAVE UNUSUAL ARCU> 
MENTS. BASICALLY. ALL I/O IS DONE IN EITHER BINARY (14) OR 
DUMP (17) MODE) HOWEVER, 3 DIFFERENT BINART MODES ARE AVAIL- 
ABLE! BINARY INPUT ONLY <BI)i BINARY OUTPUT ONLY IBO)i 
AND BINARY BOTH (BB), THE SYMBOLS BI, 60. BB AND OM (WHICH 
STANDS FOR DUMP MODE) ARE DEFINED IN FILTST TO BE USED AS 
The SET OF ARGUMENTS TO CHOOSE AMONG FOR SETMOD AND SELMOD 
MACROS. ACTUALLY BB MODE CAN ALWAYS BE USED IN PLACE DF 
BI OR BOJ THE ONLY DIFFERENCE IS THAT TWO BUFFER HEADERS ARE 
ESTABLISHED IN BB MODE (I.E. BOTH SIDES OF THE BUF ENTRY IN 
THE DATA BASE ARE SET). 

IN BiNARY MODE. DOUBLE BUFFERING IS ALWAYS USED (BUFFERS 
ARE ASSEMBLED INTO EACH PER-CHANNEL DATA BASE)i AND THE 
USUAL OVERLAPPING OF I/O WITH COMPUTATION IS MAINTAINED, 

IN DUMP MODE. WITH SPACE FOR TWO INPUT AND TWO OUTPUT BUF- 
FERS AVAILABLE, EACH OPERATION IS AUTOMATICALLY BROKEN INTO 
SOME NUMBER (POSSIBLY ZERO) OF 512 WORD TRANSFERS FOLLOWED 
(POSSIBLY) BY ONE LAST TRANSFER OF LESS THAN 512 WORDS, 
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3,8 DEFINING PROCEDURES 



tHE REHAININC HACROS (IMPLEMENTED TO DATE) IN FIUTST ARE 
USED FOR DEFINING AND CALUING TEST PROCEDURES. 

ALL TEST PROCEDURES HAVE NAMES. THESE NAMES HAyE TWO PARTS 
EACH OF WHICH MAY BE ONE OR TWO CHARACTERS LONG| THE TWO PARTS 
ARE SEPARATED BY A COMMA. THIS CONVENTION OF TWO PART NAMES, 
CONTAINIING NO MORE THAN FOUR CHARACTERS TOTAL* SEEMED A 
6000 COMPROMISE BETWEEN THE NEED TO RECOGNIZE PROCEDURE FUNC- 
TIONS EASILY FROM THEIR NAMES, AND THE NEED TO GENERATE 
UNIQUE SYMBOLS FOR EACH PROCEDURE. NO PARTICULAR CONVEN- 
TIONS ARE RECOMMENDED FOR NAMING PROCEDURES EXCEPT THAT NAMES 
SHOULD SUGGEST THE LIKELY "LEVEL" OF THE TEST PROCEDURE] 
THAT IS, SINCE PROCEDURES CAN CALL EACH OTHER RECURSIVELY, 
IT IS QUITE CONVENIENT TO WRITE AN EXPANDING SET OF GENERAL 
PURPOSE "INNER" PROCEDURES AND TO BUILD LEVELS OF "OUTER" PRO- 
CEDURES WHICH CALL THEM; NAMES SHOULD REVEAL AT LEAST WHICH 
OF THE PROCEDURES ARE OUTERMOST, 

THE MACRO PROCED MUST BE THE FIRST IN ANY PROCEDURE, AND 
tJEFlNES ITS NAMEi THE TWO ARGUMENTS TO PROCED ARE THE TWO 
PARTS OF THE PROCEDURE NAME, FOR EXAMPLE, AMONG THE SAMPLE 
PROCEDURES WRITTEN SO FAR FOR FILTST IS ONE WHICH BEGINS 

PROCED MT, UB 

tHE MNEMONIC IS INTENDED TO SUGGEST "MAIN TEST" {MEANING 
pUTERMOSt LEVEL), "UPDATE BACKWARDS," AS THE COMMENTS 
REVEAL, THIS PROCEDURE UPDATES MULTIPLE BLOCKS OF DECREASING 
RELATIVE BLOCK NUMBER, THE PROCED MACRO GENERATES THE CODE 
WHICH MAINTAINS THE ERROR TRACE PUSH DOWN STACK AND ENTRY 
eOUNtS FOR THE PROCEDURE, AND GENERATES TWO SYMBOLS OF THE 
?DRM 

X,N1N2 AND C,N1N2 

HHERC Nl AND HZ ARE THE TWO PARTS OF THE PROCEDURE NAME, 
THE FIRST SYMBOL IS THE PROCEDURE ENtRY POINT AND THE SECOND 
LABELS THE REGISTER WHERE CALLS tO THIS PROCEDURE ARE COUNTED, 
ALL PROCEDURES MUST END WITH THE MACRO ENOPR WHICH TAKES NO 
ARGUMENTS, BLOCKS WHICH BEGIN WITH PROCED AND END WITH ENOPR 
HAY BE INSERTED IN ANY ORDER WITHIN THE AUXILLIARY FILE 
(ASSEMBLED WITH FILTST) SINCE CONTROL NEVER FALLS FROM ONE 
INTO THE NEXT. 
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3,9 CALLING PROCEDURES 

TWO MACHOS EXIST FOR CALLING PROCEDURES FROM WITHIN OTHER 
PROCEDURES, (A SEPARATE MECHANISM EXISTS FOR CAULING OUTERMOST 
PROCEDURES INITIALLY AS EXPLAINED BELOW,) THE MACRO CALLPR 
TAKES TWO ARGUMENTS WHICH, AS IN THE CASE OF PROCED, ARE THE 
TWO PARTS OF A PROCEDURE NAME, CALLLPR SIMPLY GENERATES A 
PUSHJ TO THE ENTRY POINT X,N1N2, 

A RELATED KACRO, RPCALL ("REPEAT CALL"), IS USED TO CAUL 
PROCEDURES MORE THAN ONCE, IT TAKES A THIRD ARGUMENT WHtCH 
IS A DECIMAL COUNT OF THE NUMBER OF TIMES TO C*LL TH? PR8CE0URE, 
IF THIS ARGUMENT IS MISSING, THE VALUE IS TAKEN INSTEAD PROM 
THE CONTENTS OF YET ANOTHER WORD IN THE CURRENT OHANNEU DATA 
BASEi THIS WORD IS DEFINED BY THE MNEMONIC REP IN THE ARCS 
MACRO, AND IS SET AS USUAL BY MEANS OF THE SETREP (OR SEUREP 
AND FORSET) MACROS. 

RPCALL IS THE MEANS BY WHICH "LOOPS" ARE ACCOMPLISHED, ANY 
SEQUENCE OF MACROS TO BE INCLUDED IN A LOOP IS DECLARED TO 
BE A SEPARATE PROCEDURE AND CALLED THE APPRPRIATE NUHBER 
OF TIMES BY A RPCALL MACRO WITHIN SOME OTHER PROCEDURE. 
THE "TALLY" CONCEPT USUALLY ASSOCIATED WITH LOOPS IS OC- 
CASIONALLY USEFUL WITHIN FILTST PROCEDURESJ INCREMENT 
AND DECREMENT OPERATIONS WHEN NEEDED ARE ACCOMPLISHED BY MEANS 
OF DIRECT PDP-10 INSTRUCTIONS AS FOLLOHSj 

3,ia PROCEDURE STEPS WHICH ARE NOT FILTST MACROSi 

SO FAR ALL DISCUSSION OF THE FILTST DATA BASE HAS INVOLVED 
SETTING LOCATIONS WITHIN IT, THESE LOCATIONS CAN BE REFER- 
ENCED, CHECKED, INCREMENTED, ETC., BY MEANS OF DIRECT POP-IB 
INSTRUCTIONS, FIVE ACCUMULATORS MAY BE OF INTEREST TO USERS 
WRITING TEST PROCEDURES* 

ACCUMULATORS "A", "B" AND "C" ARE GUARANTEED TO BE PRESERVED 
BY ALL CODE GENERATED OR CALLED BY FILTST MACROS AND ARE 
THEREFORE AVAILABLE TO BE USED WITHIN TEST PROCEDURES, IF 
THE USER FEELS IT NECESSARY TO PRESERVE THESE ACS IN "INNER" 
PROCEDURES WHICH MIGHT USE THEM, PUSH AND POP INSTRUCTIONS CAN 
BE USED WITH ACCUMULATOR "P", FINALLY ACCUMULATOR "0" ALWAYS 
POINTS TO THE DATA BASE FOR THE CURRENT USER CHANNEL (SET 
BY THE MOST RECENT SELCHN MaCRO)i EACH OF THE- MNEMON ICS IN 
THE ARCS MACRO GENERATES A SYMBOL OF THE FORM RIBXXX WHICH 
WHEN INDEXED BY D WILL REFERENCE THAT PARTICULAR ENTRY IN 
THE CURRENT CHANNEL DATA BASE, ("RIB" WAS CHOSEN BECAUSE 
MANY, BUT NOT ALL, OF THE ENTRIES IN EACH DaTA BASE COR- 
RESPOND TO ENTRIES IN A FILES RETRIEVAL INFORMATION SLOCK.) 
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(3.ia CONT'D) 

THUS. FOR example:, the instruction sequence 

MOVE! A. 5 

AODK A.RIBNRB (0) 

HILL ADD 5 TO THE "NEXT RELATIVE BLOCK" NUMBER IN THE CURRENT 
CHANMEL DATA BASE; THE NEW VALUE WILL BE USED WHEN THE 
NEXT REOSPC OR WRTSPC MACRO IS EXECUTED (PROVIDED ITS SECOND 
ARGUMENT IS MISSING IN THE CALL), 

REGISTERS WITHIN THE "JOB STANDARD" DATA BASE may SE REFER- 
ENCED AS SYMBOLIC LOCATIONS USRXXX WHERE XXX MATCHES ANY 
MNEMONIC IN THE ARCS MACRO) (NO INDEX REGISTER IS USED IN 
REFERENCES TO LOCATIONS USRXXX), 

3,11 THE TEST TABLEi 

IN ADDITION TO A COLLECTION OF SEPARATE PROCEDURE DEFINITIONS 
IN NO PARTICULAR ORDER, THE AUXILLIARY FILE ASSEMBLEO 
WITH FILTST MUST CONTAIN A TABLE WHOSE STARTING LOCATION 
is TESTS AND WHOSE CONTENTS DEFINE THE ORDER IN WHICH THE 
OUTERMOST LEVEL OF TEST PROCEDURES ARE TO BE CALLED WHEN 
FILTST IS RUN, 

ONE MACRO, CALLED DO, IS USEFUL FOR SPECIFYING ENTRIES IN 
THE TESTS TABLE. ITS FIRST TWO ARGUMENTS ARE THE TWO PARTS 
OF THE NAME OF SOME PROCEDURE TO BE EXECUTED, AND ITS THIRD 
ARGUMENT, IF PRESENT, IS A DECIMAL COUNT OF THE NUMBER OF TIMES 
THAT PROCEDURE IS TO BE EXECUTED BEFORE THE NEXT ENTRY IN 
THE TEStS Table is seen, the tests table is THERFORE a LIST 
OF 00 MACROS AND MUST BE FOLLOWED BY A WORD CONTAINING 
2ER0'. WHEN THE HERO WORD IS ENCOUNTERED DURING EXECUTION, 
THE LIST OF TESTS IS REPEATED FROM THE BEGINNING, MORE 
iNFORMATION ABOUT THE STRUCTURE AND USE OF THE TESTS TABLE 
CAN BE FOUND IN THE FILTST LISTING ON THE PAGE WHEREON THE SYM- 
BOL DOTEST IS DEFINED, USE OF THE DO MACRO RESULTS {N THE 
GENERATION OF COMMENTS IN THE LISTING WHICH NUMBER THE ENTRIES 
IN THE TEST TABLE FOR EAST IDENTIFICATION DURING DEBUGGING, 

THE ONLY OTHER CONSTRUCTION WHICH MUST BE PART OF THE AUX- 
ILLIARY FILE ASSEMPLED WITH FILTST ARE THE TWO LlNESl 

LSTECT I XWD ZCHA1N,0 

AND 
END START 

THE FIRST OF THESE SPECIFIES THE END OF A CHAIN LIST THROUGH 
WHICH THE ENTRY COUNTS OF ALL PROCEDURES ARE LINKED (SO THAT 
THEY MAY BE CLEARED AT APPROPRIATE TIMES), THE FILTST STARTING 
ADDRESS IS START, DEFINED NEAR THE END OF THE MAIN FILTST FILE, 
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4, FILTST OPERATION 

4.1 THE ERROR TRACE 

UPON ANY ERROR MESSAGE {AND WHENEVER THE W COMMAND JS 
TYPED - SEE 8EU0W) A PRINTOUT OF THE CURRENT TRACE STACK 
is GENERATED. THE TRACE SHOWS WHAT STEP OF WHAT PROCEDURE 
WAS SEING EXECUTED WHEN THE ERROR OCCURRED* AND BY EXACTLY 
WHAT PATH CONTROL HAD REACHED THAT POINT. THE TRACE BEGINS 
WITH THE CURRENT INDEX INTO THE TESTS TABLE (PRINTED IN OCTAL 
SINCE THE 00 MACRO NUMBERS THE ENTRIES IN OCTAL IN THE LISTING). 
A DECIMAL NUMBER IS GIVEN IN PARENTHESIS WITH EACH PROCEDURE 
NAMED IN THE TRACE! IT IS THE NUMBER OF TIMES THAT PROCEDURE 
HAS BEEN CALLED SINCE THE TESTS TABLE INDEX WAS INCREMENTED tO 
ITS PRESENT VALUE. THAT IS, THE ENTRY COUNTS FOR ALL PROCEDURES 
ARE CLEARED WHENEVER ANY ENTRY IN THE TESTS TABLE HAS BEEN COM- 
PLETED. {SINCE ENTRY COUNTS ARE PART OF THE "PURE" PROCEDURE 
OEFIMTIONS IN FILTST'S HIGH SEGMENT, THIS FEATURE IS MOST USEFUL 
WHEN ONLY A SINGLE JOB IS USING THE HIGH SEGMENT,) AS AN EXAMPLE. 
THE tRACEl 

5 RD.DL " 9 (1) / OP.RD — 3 (2) 

INDICATES THAT CONTROL IS CURRENTLY AT STEP 3 OF PROCEDURE 
OPiRb (AND THAT THIS IS THE SECOND CALL TO OP.RO), JT SAYS 
THAT OP,RD WAS CALLED BY STEP 9 OF PROCEDURE RD,DL (DURING THE 
FIRST CALL TO RD.OL), AND THAT RD.DL WAS CALLED DIRECTLY AS A 
RESULT OF THE DO MACRO COMPRISING THE FJFTH ENTRY IN THE TESTS 
TABLE. NOTE THAT ONLY THOSE PROCEDURE STEPS WHICH ARE FJLTST 
MACROS ARE COUNTED AS STEPS; IN DETERMINING WHAT LINE OF A 
PROCEDURE CORRESPONDS TO WHAT STEP, ONE MUST NOT COUNT ANY 
LINES COMPRISING BASIC PDP-10 INSTRUCTIONS, 

ANY FURTHER INFORMATION REQUIRED FOR ANALYSIS OF THE PROBLEM 
(IF THE TRACE WAS PRODUCED AS THE RESULT OF SOME PROBLEM) MUST 
3E OBTAINED THROUGH DOT WHICH IS TYPICALLY LOADED WITH 
FILTST, 
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4,2 FILTST CDMMANOS 



WHEN FILTST tS RUNNING, IT ACCEPTS A SET OF SINGLE CHARACTER 
COMMANDS WHICH MAY BE TYPED AT ANY TIME, THE CONSOLE INPUT 
BUFFER IS CHECKED FOR THE PRESENCE OF COMMAND CHARACTERS AFTER 
EVERY UUO IS EXECUTED, SOME COMMANDS ARE PROCESSED WITHOUT 
STOPPING THE TEST SEQUENCE IN PROGRESS; OTHERS INTERRUPT THE 
RUNNING OF FtLTST IN CONVENIENT WAYS. THE PAGE OF THE FILTST 
LISTING ON WHICH THE SYMBOL COMTAB IS DEFINED DESCRIBES HOW NEW 
COMMANDS MAY aE ADDEOJ THOSE WHICH HAVE BEEN IMPLEMENTED TO DATE 
ARE DESCRIBED IN THE PARAGRAPHS BELOW. AND SUMMARIZED IN APPEN- 
DIX LL. 

AS MiENTIONED ABOVE, THE COMMAND W (MNEMONICS FOR "WHERE" ARE 
WET) MAY 8E TYPED AT ANY TIMEJ WHEN CONTROL RETURNS FROM THE 
NEXT UUO, The TRACE STACK WILL BE PRINTED SO THAT, BY REFERENCE 
to THE AUXILLIARY FILE LISTING, THE USER CAN DETERMINE MOW 
FAR tHE TEST SEQUENCE HAS PROGRESSED. ERROR MESSAGES CONSIST 
OF AN ERROR NUMBER OF THE FORM EXX AND THE TEXT OF THE MESSAGE, 
OUTPUT CAN BE ABBREVIATED TO THE ERROR NUMBER ALONE BY MEANS 
OF THE A COMMAND! THE "LONG" FORM CAN BE RE-ENABLEO BY MEANS 
OF THE L COMMAND. 



4,3 FILTST AND DDT 



|T IS INTENDED THAT DOT BE LOADED WITH FILTST FOR INTERACTIVE 
INVESTIGATION OF OBSCURE ERRORS, IT IS FURTHER INTENDED THAT A 
DDT BREAKPOINT BE INSERTED AT LOCATION BREAK IN FRTST'S 
LOW SEGMENT, INSERTING A BREAKPOINT AT THIS LOCATION, WHICH 
Is OTHERWISE INITIALIZED TO CONTAIN A POPJ INSTRUCTlt3N. ENABLES 
TWO OTHER USEFUL FILTST COMMANDS, FILTST CAN BE MADE TO EXECUTE 
A PUSHJ TO BREAK, WHICH WRL THEN ENTER DDT VIA THE BHEAK» 
POINf. AT Two PREDICTABLE TIMES. THE "SPACE" COMMAND <THE CHAR- 
ACTER "SPACE") WILL CAUSE THE PUSHJ TO BE EXECUTED AS SOON AS 
THE COMMAND IS PROCESSED - THAT IS, AS SOON AS THE NEXT UUO 
is EXECUTED, THE S (MNEMONIC FOR "STOP") COMMAND WILL CAUSE 
THE PUSHJ TO BREAK WHEN THE TEST PROCEDURE INDICATED IN THE CUR- 
RENT POSfTION OF THE TESTS TABLE IS COMPLETE. THAT IS, S HILL 
STOP FtLTST WITH NO PROCEDURE IN PROGRESS AS IT IS JUST ABOUT 
TO BEGIN ANOTHER "OUTERMOST" PROCEDURE. NEITHER THE "SPACE" 
NOR THE S COMMAND HAVE ANY EFFECT IF A BREAKPOINT HAS NOT BEEN 
PLACED AT LOCATION BREAK. 
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4,4 AFTER AN ERROR MESSAGE 



EXCEPT AFTER AN ERROR MESSAGE, FILTST COMMANDS ARE PROCESSED 
WHENEVER THEY ARE TYPEO. BUT NONE ARE EVER REQUIRED, AFTER AN 
ERROR MESSAGE HOWEVER. AT LEAST ONE OF THE "ACTION TYPE" COM- 
MANDS IS REOUIRED AND IS WAITED FOR. IN THE TABUE OF COMMANDS 
(CQMTAB IN FILTST LISTING)i TWO COMMANDS ARE CURRENTLY FLAGGED 
AS ACTION COMMANDS! ONE OR THE OTHER OF THESE MUST BE TYPED 
THE USER AFTER ANY ERROR. ONE IS THE "SPACE" COMMAND WHICH 
CAUSES DDT TO BE ENTERED (AS DESCRIBED ABOVE) SO THAT THE ERROR 
MAY BE INVESTIGATED! THE OTHER IS THE "C (FOR "CONTINUE") 
COMMAND WHICH CAUSES FILTST TO PROCEDE AND IGNORE THE ERROR, 
IT IS INTENDED TO BE POSSIBLE TO CONTINUE FROM ANY ERROR THAT 
MIGHT OCCUR WITH INTERNAL CONDITIONS SET AS THEY MOULD HAVE' BEEN 
HAD THE ERROR NOT OCCURRED, TYPING C MAY WELL RESULT IN OTHER 
RELATED ERRORS BEING DETECTED, BUT AT LEAST WILL NOT LOOP ON A 
SINGLE ERROR, IT IS HOPED THAT WHEN AN ERROR DOES OCCUR, THE 
ERROR TRACE STACK (PRINTED AUTOMATICALLY), WILL BE SUFFICIENT 
INFORMATION FOR ANALYSIS OF THE PROBLEM, (IN CONJUNCTION WITH 
THE FILTST LISTING), AND THAT TYPING "C" HILL RESULT IN A 
SUCCESSFUL "CONTINUE" SUCH THAT FURTHER ERRORS WHICH OCCUR 
WILL BE SEPARATE SITUATIONS FOR LATER ANALYSIS, THE "C" COMMAND 
HAS NO EFFECT IF TYPED WHILE FIlTST IS RUNNING, ALL CHARACTERS 
WHICH ARE NOT COMMANDS (INCLUDING CARRIAGE RETURN AND LINE FEED) 
ARE IGNORED, 



4.5 ODT TECHNiauES 



THE FILTST LISTING SHOULD BE CONSULTED FOR COMPLETE INFORMATION 
ON INTERNAL STRUCTURE, ESPECIALLY PAGE 3 WHEREON THE IMPURE DATA 
BASE IS DEFINED, A FEW REGISTERS IN THE DATA BASE WERE INCLUDED 
SPECIFICALLY FOR DEBUGGING PURPOSES! THEIR SPECIAL FUNCTIONS ARE 
EXPLAINED MORE FULLY HERE THAN IN THE LISTING COMMENTS, 

ACCUMULATORS OF SPECIAL INTEREST DURING DEBUGGING ARE! 
P - THE CONTROL PUSH-DOWN POINTER 
TR - THE TRACE STACK PUSH-DOWN POINTER 
D - POINTER TO THE DATA BASE FOR THE CURRENT 

USER CHANNEL 
U - ALWAYS CONTAINS THE LAST UUO EXECUTED 

LOCATION TRLAST CONTAINS THE NAME OF THE LAST PROCEDURE SUC- 
CESSFULLY COMPLETED (LOADED BY EVERY ENOPR MACRO), THE TWO 
HALVES OF THE PROCEDURE NAME ARE IN LEFT JUSTIFIED 7-BIT ASCII 
IN THE TWO HALVES OF THE WORD - A RATHER INCONVENIENT FORMAT 
FOR OQT, UNFORTUNATELY. 
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(4.5 CONT'D) 



tHREE LOCATIONS JN EACH CHANNEL DATA 9ASE (NO NEED FOR THEM 
to BE PART OF "JOB STANDARD" DATA BASE) ARE OF SPECIAL 
INTEREST FOR DEBUGGING: 

LOCATION CHNCNT CONTAINS IN ITS LEFT HALF A SET OF BITS, ONE 
BIT FOR EACH OF THE POSSIBLE UUOS, SHOWING MHICH UUOS HAVE 
BEEN EXECUTED ON THIS CHANNEL, IN THE RIGHT HALF, THERE IS 
A COUNT OF THE NUMBER OF UUOS WHICH HAVE BEEN EXECUTED ON 
THIS CHANNEL <T0 ACCOUNT FOR THE FACT THAT SOME UUOS MAY 
HAVE BEEN EXECUTED SEVERAL TIMES), CHNCNT IS INITIALIZED 
TO ZERO JUST BEFORE ANY OPEN UUO IS EXECUTED ON THAT CHANNEL 
80 THAT The CHANNEL HISTORY REMAINS EVEN AFTER A RELEASE UUO. 

LOCATION CHNARG HAS A BIT POSITION FOR EACH OF THE ENTRIES 
IN THE ARCS MACRO! THAT IS. FOR EVER DATA BASE ENTRY FOR 
WHICH THERE IS A SETXXX MACRO. IT IS INITIALIZED TQ ZERO 
UPON ANY RELEASE UUO, AND IS USED TO REMEMBER WHICH ENTRIES 
HAVE BEEN SET <BY SETXXX OR FORSET OR INSURE! SINCE THE 
RELEASE. CHNARG IS USED BY THE INSURE MACRO TO DETERMINE 
WHICH ENTRIES MUST BE SET FROM THE JOB STANDARD DATA BASE. 

LOCATION CHNCR6 ALWAYS CONTAINS THE "CURRENT RELATIVE BLOCK" 
NUMBER WHICH FILTST EXPECTS TO READ OR WRITE NEXT, IT IS 
SET UP BY ANY XCTSTI ON XCTSTQ MACRO, BUT MORE IMPORTANTLY, 
IT IS INCREMENTED ON EVERY INPUT OR OUTPUT UUO DONE BY FlLTST. 
ITS CONTENTS ARE WRITTEN INTO ANY OUtPUT BLOCK AND CHECKED UPON 
READING ANY INPUT BLOCK, THAT IS, AMONG OTHER THINGS EVERY 
BLOCK OF ANY FILE CREATED BY FILTST CONTAINS ITS OWN RELATIVE 
BLOCK NUMBER, IF THE ERROR MESSAGE "INCORRECT RELATIVE BLOCK 
NUMBCR IN INPUT DATA" APPEARS, THE USER CAN FIND THE EXPECTED 
NUMBER IN CHNCRB AND THE ACTUAL NUMBER IN THE CURRENT INPUT 
BUFFER (AS THE IMPURE DATA BASE DEFINITION IN FU.TST LISTING 
WOULD REVEAL. LOCATION I6HBLK IN THE CHANNEL DATA BASE m FOUND 
THRU ACCUMULATOR D - IS THE INPUT BUFFER HEADER POINTER) THE 
RELATIVE BLOCK NUMBER IS THE FIRST DATA WORD IN ANY SUFFER 
AS THE TABLE AT LOCATION ITMLST WOULD REVEAL). 

NOTE THAT ALL OF THE ABOVE SYMBOLIC LOCATIONS ARE RELATIVE 
to THE CURRENT CHANNEL DATA BASE. USING DDT, ONE FINDS THE 
6URRENT DATA BASE BY TYPING 0/ AND THEN PERHAPS S0<0B| SUCH 
THAT FROM THEN ON ONE CAN TYPE DB+CHNCRB/ ETC. 
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FEATURES YET TO BE IMPUEMENTEO 



A NUMBER OF FEATURES PLANNED FOR FILTST ARE NOT IMPLEMENTED 
AS OF THIS WRITING. THEIR ABSENCE DOES NOT PRECLUDE THE 
USE OF FILTST AS AH EFFECTIVE TEST VEHICLE IN ITS PRECENT 
STATE; HOWEVER. SINCE THE STRUCTURE OF THE PRESENT VERSION 
IN SOME WAYS REFLECTS THE ANTICIPATED INCLUSION OF THESE 
FEATURES IT IS WELL FOR ANYONE WHO MIGHT MODIFY THE PRESENT 
VERSION TO HAVE CONSIDERED THE FOLLOWING POINTSi 

1, MULTI-JOB FEATURES; SOME COORDINATED TESTS CAN BE 
PERFORMED ONLY WITH TWO (OR MORE) JOBS ACTING IN A 
SYNCHRONOUS FASHION ON THE SAME FILES, IT IS PLANNED 
THAT FILTST INCLUDE AN OPTION TO ESTABLISH ONE <0R 
MORE) ADDITIONAL JOBS THROUGH THE PSEUDO-TELETYPE 

TO SYNCHRONUE THE ACTIVITY OF THIS SLAVE JOB WITH 
THE MAIN JOB'. 

A SIMPLE MECHANISM TO ACCOMPLISH THIS SYNCRONIZATION 
MIGHT INVOLVE TWO SEPARATE TESTS TABLES, ONE TO DRIVE 
EACH OF THE JOBS, WITH ALL PROCEDURES BEING SHARED AS 
USUAL. A SINGLE MACRO MIGHT BE DEFINED FOR INCLUSION 
IN EITHER TESTS TABLES WHICH SAYS IN EFFECTi "PUT THIS 
JOB INTO IDLE (SLEEP LOOP) AND START THE OTHER JOB 
AGAIN", THE TWO JOBS WOULD NOT RUN IN PARALLET, BUT 
RATHER IN SEE-SAW FASHION TO ACCOMPLISH SYNCHRONIZED 
ACTIONS. (THE EFFECT OF MULTIPLE COPIES OF FILTST 
RUNNING TO CREATE AN INTERESTINGLY HEAVY LOAD IS 
EASILY ACHIEVED WITH THE PRESENT VERSION OF FILTST BY 
RUNNING MULTIPLE JOBS, SHOWING THE HIGH SEGMENT, AND 
STARTING EACH WITH A DIFFERENT INITIAL OFFSET INTO THE 
tESTS TABLE.) 

THE MAJOR REASON WHY MULTI-JOB FEATURES HAVE NOT YET 
BEEN IMPLEMENTED IS THE TIME REQUIRED TO DESIGN AND 
IMPLEMENT THE CODE WHICH DEALS WITH THE PSEUOD-TELETYPE 
AND WHICH HANDLES THE PRINTING OF ERROR MESSAGES (AND 
The SUBSEQUENT COMMAND INPUT) FOR THE JOB(S) BEING 
CONTROLLED BY THE PTY(S), 

2. CURRENTLY THE TWO MACROS XCTSRC (SEARCH UUO) AND 
XCTSEK (SEEK UUO) ARE NOT CODED. THEY PRESENT NO 
DIFFICULTY BUT WERE NOT USEFUL IN DEBUGGING FILTST 
UNDER LEVEL C DISK SOFTWARE, 
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(5. CONT'D) 



s', tHERE Should be a privileoeq uuo iMPtEHENTEo in the 

MONITOR WHEREBY A PRIVILEGED JOB COULD CHANGE THE 
PROJECT PROGRAMMER NUMBERS IT WAS "LOGGED IN UNDER", 
tHEN A FILTST MACRO SHOULD BE DEFINED TO EXECUTE THJS 
UUO {E.G.. CNGPP^! PJ. PG) SO THAT FILTST PROCEDURES 
COULD BE i<RITTEN TO TEST THE VARIOUS FILE PROTECTION 
FEATUftES OF THE MONITOR. 

4-, AS PART OF ITS INITlALIZATrONr FILTST COULOi AND 

PW3*BA8UY SHOULD, GfiE*TE UFQS FOR ALL OF THE ENTRIES 
i-N OIR.XX TABLE IN EACH OF THE STRUCTURES IN THE STR.XX 
tABU. IF SUCH UFOS DID NOT ALREADY EXIST. THIS ACTION 
WOULD HEQ4J-IRE TH*T FILTST BE ABLE TO TEHPORaRILY ASSUME 
MASTER rii-E PRIVILEGES AS IT COULD DO WITH THE CNOPPN 
MACRO IN 3' ABOVE, 

5, R-*THER TM*N ASSEMBLING INTO FILT'ST THE VARIOUS OPTIONS 
AVAILABLE TO TEST PROCEDURES FOR THOSE DATA BASE 
ARGUMENTS- OF MORE THAN 19- BITS-, THESE TABLES (XXX.YY) 
COULD BE SET CONV€RSjITI0NM.LY BY MEANS OF AN 

i'NiT lAtrzATnaM dialogue , 

6, FINALLY,, m R€ASON< HAS BEEN^ FOUND SO FAR FOR FILTST TO 
ija ANY OF THE FOLLOillNCi IT SEEMS HOWEVER, THAT THE 
F*CT THAT FTtTST DOES NOT FliNO ANY R€AS0K TO 00 THES£ 
tHINCS SHOULD BE MENTIONED, 

Af,. USE THE ma WHtCH ALLOWS SETTING- ANO/OR INTERROGATrNC 
A JOSS FILE SEAWCHLIST,. 

B., use THE UUOS WHICH' ALLOW' INTERROGATING WHICH 
FILeSTHUCTURES EXIST 0» OBTAIN-rNC THEIW 
CHA«*CTERISTICS, 

C. ATTEMPT TO REMCMBER THE STATES (CONTEWTS) OF THE 
VAHIflUS UFDS IN THE DIR.X* TABLE, 

6, ALLOW ANY ABiLITY TO INTRODUCE RANDOHNEOS INTO 
TEST PROCEDURES, 
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APPENDIX I FILTST MACROS AND THEIR ARGUMENTS 

MACRO ARGUMENTS SHOWN BELOW ARE TO BE INTERPRETED 
AS FCLLOWSI 

N - ANV DECIMAL INTEGER 

A - ONE OR Two CHARACTERS CORRESPONDING TO THOSE 

CHARACTERS FOLLOWING THE PERIOD IN A TABLE LOCATION 
OF THE FORM XXX. XX WITHIN FILTST 

- ANV OCTAL INTEGER 

M - ANY ONE OF THE SYMBOLS 81 i BO, BB OR DM 

iST P A STRING OF THREE CHARACTER MNEMONICS (FOUND 

WITHIN THE ARCS MACRO IN FILTST) SEPARATED BY COMMAS 
AND ENCLOSED IN ANGLE BRACKETS 

R - ONE OF THE CHARACTERS N, Ei X OR ANY DECIMAL 
INTEGER 

S - A STRING OF FIVE CHARACTERS FROM THE SET Xi 
e OR 1 

L - ANY SINGLE CHARACTER OR ANY TWO CHARACTERS 

A PERIOD AS PART OF ANY ARGUMENT INDICATES THAT THE 
ARGUMENT MAY BE MISSING, THE ABSENCE OF A PERIOD 
INDICATES THAT THE ARGUMENT MUST BE PRESENT 

» - AN ASTERISK FOLLOWING A MACRO INDICATES THAT THE 
MACRO IS CHANNEL INDEPENDENT, THE ABSENCE OF AN 
ASTERISK INDICATES THAT THE MACRO PERTAINS TO 
THE CHANNEL DECLARED BY THE MOST RECENTLY EXECUTED 
SELCHiS MACRO 
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A, SELECTING A CHANNEL 

SELCHN N • 

B, SETTING CHANNEL DATA BASE (NOTE! FOR EVERY SETXXX 
MACRO BELOW, THERE IS A CORRESPONDING SELXXX MACRO 
WITH IDENTICAL FORMAT ARGUMENTS FOP MODIFYING THE 
JOB STANDARD, CHANNEL iNDEPENtJENT DAtE BASE,) 



SETMOO 
SETSTR 

setarg 

SETDIR 
SETNAM 

setext 

SETPRT 
SETEST 

setalc 

SETPOS 

SETVCR 

SETREP 

SETNRB 

SETXFW 

SETPAT 

RSTEXT 

RSTPRT 

CLRVAL 

FORSET 1ST 

INSURE 1ST 



M 
A 

N 
A 

A 
A 


N 
N 
N 
N 
N 
N 
N 
N 



N 



DATA MODE 

FILE STRUCTURE 

NO, OF EXTENDED LKP-ENT-REN ARGUMENTS 

DIRECTORY <PJ, PG) 

FILE NAME 

FILE EXTENSION 

FILE PROTECTION 

ESTIMATED LENGTH 

HIGHEST BLOCK TO ALLOCATE 

WHERE TO ALLOCATE 

VERSION NUMBER 

REPEAT COUNT FOR RPCALL 

NEXT RELATIVE BLOCK FOR RED i WRTSPC 

WORDS TO TRANSFER FOR ALL RED t WRT 

DATA PATTERN FOR ALL RED i wRT 

CLEAR RIBEXT RH 

CLEAR RIBPRT BITS 9 . 35 

CLEAR DATA BASE, START AT WQRO N 

FORCE SETTING FROH STANDARD DATA BASE 

SET FROM STANDARD DATA BASE IF 
NOT ALREADY SET 
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C, DECLARING EXPECTATIONS 
EXPECT R,,S, 



, EXECUTING UUO'S 




XCTOPN 


OPEN 


XCTLKP 


LOOKUP 


XCTENT 


ENTER 


XCTREN 


RENAME 


XCTSTO N 


USETO 


XCTSTI N 


USETI 


xcTcLs n; 


CLOSE 


XCTRtS 


RELEASE 


REDNXT N'. ,N,» 


WORDS, PATTERN 



) 

WRTNXT N'..N,> 

REDSPC N.,N.,N.)WORDS, BLOCK #, PATTERN 

> 
WRTSPC N.,N,,N,> 



E, DEFINING PROCEDURES 



PROCEO 


111 


ENDPR 




CALLPR 


111 


RPCALL 


liliN. 



P, THE TESTS TABLE 

DO liliN, 



7, 



APPENDIX II 

CHARiCTER 

SPACE 

S 

C 

w 

A 

L 
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FILTST COMMANDS 

ACTIDN 

HIT DDT BREAKPOINT IMMEDIATELY 

HIT DDT BREAKPOINT WHEN CURRENT STEP OF 
TEST TABLE COMPLETE 

CONTINUE AFTER AN ERROR 

PRINT CURRENT TRACE STACK WITHOUT STOPPING 

ABBREVIATE ERROR MESSAGES TO ERROR NUMBER ONLY 

TYPE COMPLETE ERROR MESSAGES 
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THE INFORMATION IN THIS MEMORANDUM IS SUBJECT TO 
CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED 
AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION, 



THE PROGRAM DESCRIBED IN THIS 
DEVELOPED TO AID THE STUDY Of THE 
IT is NOT A SUPPORTED PRODUCT, BUT 
CUSTOMERS ON A FOR INFORMATION 
BASIS, 



MEMORANDUM MAS 

POP»10 MONITOR, 

IS AVAILABLE TO 

PURPOSES ONLV 
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t,» PURPOSE 

TH£ SCRIPT PPOCRAH ALLOWS PREOETERHINEO SEOUENCES Of 
CHARACTERS TO BE SENT OVER MULTIPLE PSEUDO-TELETYPES AND 
THfRCBY ALLOW THE SIMULATION OF A LOAD ON THE TIME-SHARING 
SYSTEM, THE RESULTS OF A RUN CAN 8E WATCHED ON-LINE AND 
STATiSTlca Of RESPONSE TlMEi ETC, CAN BE RtCORDEO ON THE 
SYSTEM DfSK, 

2,0 Job CAPABILITY 

tHC SCRIPT PR06RAM HAS B£E>I WRITTEN. AS A REENTRANT PR«C1**M, 
THE CODE AND TEXT TO K SENT APE IN THE HIGH SEGMENT AND CAN 
BE SHAREO BY SEVER«L. JOB*» EACH WITH^ A IK LO* SE6MEIiT, EACH 
JOB CAM CONTROL UP TO t4 OftES, SO TT BECOMES POSSIBLE TO 
SIMUi;*tE A ihSKi NUMSER OF POP-tB TIME-SHARIWI USERS, 

S,0 COtfTRCL FEATURES 

The script ts- loaded into the high segment from any pdp-V0 
Input ofvtcf , in addition to the text to be sent, control 

COMKANM C*N BI tNCLUDED TO DETERMINE THE SPEED AT WHICH THE 
SIMULATEO USERS HtLL OPERATE. 

3;t tiMINC PARAMETERS 

PARAMETERS SUBJECT TO VARIATION INCUUDE TYPE- IN TIME» 
tYREiOUT TIMEi. *N0 USER "TWINK" TIME. THE TTPE-IN AND 
tTN-OUT TIME cm BE SPECIFIED AS A CONSTANT OR kS A RATE, 
il» WHICH CiSE THE TIME WOULD DERCWO ON THE NUMBER OF 
CHARACTERS SfRt OR RECEIVED, THE "THtN)«» TIME IS BROKEN UP 

pta Two PA#TS» X) The allowco response time, and zy "free" 

TIME', t^ The computer StWES INSTANTAIiEQUS RESPONSE TO A 
COMMANOr THE tOTAt BELAY IS SlMPLT THE SUM OF THE TWO 

og*NTrttis, if response ts greater rwnn allowed • "think" 

flME IS EttUit to the "FREE" TIME, IN BETWEEN, "THINK" TIME 

is THE Sim or alloweo response plus "free* time minus the 

ACtUAU COMPUTER RESPONSE TO THE COMttANO, ONE AOOITIONAL 
TIME FACTOR ALLOWED IS THE ABILITY TO SET A MAXIMUM RESPONSE 

PLUS Type-out delay for a given command, if the command 

EXCEEDS mis LlMiT, THEN THE JOB IS INTERRUPTED BY SENOINS 
TWO GOHfROLiC CHARACTERS OVER THE PSEUDO TELETYPE, THIS 
ALLOWS A SCRlPt TO INCLUDE PROBRAM LOOPS WHICH ARE 
INTERRUPTED AFTER A SPECIFIED TIME INTERVAL, 

3,i REPEtlTlbN OF SCRIPTS 

AN ADDITIONAL SCRIPT LANGUAGE FEATURE ALLOWS THE SCRIPT TO 
SPEcIfV how many TIMES IT WILL BE EXECUTED. SO THAT STEADY 
STATE LQAOiNti CONDI TtONS CAN BE MEASURED, 
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3.3 STAGGERING LOAD BUILDUP 

WHEN MULTIPLE JOBS ARE TO FOLLOW THE SCRIPT, THE SCRIPT MAY 
SPECIFY A STAGGERING INTERVAL SO THAT LOAD BUILDUP CAN BE 
GRADUAL, 

3.4 MULTIPLE USER NUMBERS 

AS AN OPTIONAL FEATURE, THE SCRIPT PROGRAM WILL CONVERT THE 
••#" CHARACTER INTO AN OCTAL STRING EQUAL TO THE PTY UNIT 
NUMBER, THIS WILL ALLOW ONE SCRIPT TO LOG MANY JOBS IN 
UNDER DIFFERENT NUMBERS OR FOR MULTIPLE JOBS TO USE SEPERATE 
FILES. 

4,e LOGGING OF RESULTS 

THE SCRIPT PROGRAM MAKES AN ENTRY IN THE LOG FILE FOR EACH 
LINE OF PTY DATA SENT TO THE TIME-SHARING SYSTEM^ THE TIMEi 
IDENTITY OF A PARTICULAR JOB, NUMBER OF CHARACTERS SENT, 
MUM8ER OF CHARACTERS RECEIVED, NUMBER OF BUFFERS RECEIVED, 
AND TOTAL RESPONSE TIME ARE ALL RECORDED, IN ADDITION, 
DELAYS IN SENDING OR SIMULATING TELETYPE OUTPUT DUE TO POOR 
SCRIPT PROGRAM RESPONSE ARE ALSO RECORDED, THIS PROVIDES 
SOME IDEA OF HOW THE RESPONSE TO THE CONTROLLING JOB 
AFFECTED SYSTEM LOAD AND RESPONSE TIME MEASUREMENTS, 
IDEALLY THE CONTROLLLING JOB WOULD BE REAL-TIME, E.G. HIGH 
PRIORITY AND LOCKED IN CORE. DELAYS TO THE SCRIPT 
INPUt/OutPUT LIGHTEN THE OVERAL SYSTEM LOAD, WHILE DELAYS IN 
RECEIVING REQUESTS FOR MORE INPUT ARE MEASURED AS IF THE 
USER JOB HAO EXPERIENCED HORSE RESPONSE THAN IT ACTUALLY 
DID, 

AS A FURTHER CHECK ON ERRORS IN RESPONSE TIME MEASUREMENTS 
OUE TO POOR SCRIPT PROGRAM RESPONSE, A "+" CHARACTER IS 
OUTPUT WHEN POOR SCRIPT PROGRAM. RESPONSE MAY HAVE CAUSED THE 
PT WAKE FUNCTION IN THE MONITOR TO FAIL, WHEN THIS HAPPENS, 
THE SCRIPT PROGRAM WILL WAKE UP BASED ON ITS SLEEP INTERVAL 
AND NOT ON OBJECT JOB RESPONSE. NORMALLY, THE MONITOR 
RESETS THE SLEEP COUNT WHEN A JOB RUNNING ON A 
PSEUDO-TELETYPE NEEDS SERVICE, THE SCRIPT PROGRAM TESTS THE 
PTY FLAGS, AND IF THE PTY DOESN'T NEED SERVICE SLEEPS, 
IDEALLY, THIS SLEEP WILL BE TERMINATED IMMEDIATELY BY THE 
MONITOR, HOWEVER, SHOULD THE SCRIPT PROGRAM BE RESCHEDULED 
BETWEEN TESTING THE PTY AND DOING THE SLEEP, THIS CAN'T 
HAPPEN, IN THIS CASE, THE SCRIPT PROGRAM COULD SLEEP FOR 
ITS MAXIMUM INTERVAL, THIS COULD BE UP TO 5 SECONDS, 
UNFORTUNATELY. THERE IS NO WAY TO TELL IF THIS HAPPENED, 
THE "♦" IS SET WHENEVER A JOB GETS RESPONSE AND THE TIME OF 
PAY EXCEEDED THE TIME OF DAY THE SLEEP ENTRY WOULD HAVE 
TERMINATED. THIS CAN OCCUR ALSO OUE TO POOR RESPONSE ONCE 
THE SLEEP INTERVAL HAS TERMINATED, 
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4.1 OErjNITJON OF RESPONSE TIME 

THE RESPONSE TIME MEASURED IS THE TOTAL TIME FRQi^ OUTPUTTING 
CTYPING") A LINE OVER THE PTY UNTIL THE PROGRAM REQUESTS 
THE NEXT LINE OR TIMES OUT TO TWO CONTROL-C CHARACTERS, LESS 
TIME SPENT SIMULATING TTY OUTPUT. THUS, IF ONE LINE TO THE 
SYSTEM PRODUCES 50 LINES OF OUTPUT, ONE RESPONSE TIME WILL 
BE RECORDED. WHICH IS THE TOTAL TIME THE USER WAS WAITING 
FOR THE COMPUTER. 

4.2 OVERLAP AND ITS EFFECT ON RESPONSE TIME MEASUREMENTS 

THERE IS ONE POSSIBLE DIFFlCULTYl OVERLAP BETWEEN OUTPUT AND 
THE NEXT INPUT. NORMALLY AN OUTPUT-BOUND PROGRAM IS WOKEN 
UP WHEN 8 CHARACTERS OF SPACE REMAIN IN THE MONITOR BUFFER, 
tHUS A 0.S SECOND DELAY <AT 12 CHARACTERS/SEC) WOULD NOT 
CAUSE A PAUSE IN TYPE-OUT. UNFORTUNATELY, THE PTY TRANSFERS 
A LINE AT A TIME, SO THIS OVERLAPPED TIME IS LOST. THE NET 
AFFECT IS TO MAKE THE MEASURED RESPONSE TIMES LOOK A LITTLE 
WORSE THAN RESPONSE TIMES AN ACTUAL TTY USER WOULD SEE, 
INCIDENTALLY, SHOULD THE PROGRAM REQUEST INPUT WHILE TYPEOUT 
IS IN PROGRESS, ALL TYPEOUT DELAY WILL BE COMPLETED BEFORE 
ACTING ON THE INPUT REQUEST. 

4.3 DIFFERENf BUFFERING MODES 

IF THE SfiRIPt SPECIFIED OUTPUT AS A FUNCTION OF TIME, THEN 
THE SCRIPT PROGRAM WAITS UNTIL THE DELAY IS UP, THEN DATA IS 
TRANSrERfiED OVER THE PTY TO THE SCRIPT PROGRAM, WHEN THE 
SCRIPT SPECIFIES AN OUTPUT RATE, THE SCRIPT PROGRAM MUST 
FIRST READ THE DATA FROM THE PTy, DETERMINE THE DELAY, AND 

THEN Sleep, specifying one mode or the other may be 

APPROPRIATE TO PARTICULAR PROGRAMS DUt TO DIFFERENT 
BUFFERING MOOES. 

4.4 ANALYSIS OF RESPONSE TIME RESULTS 

IN ANY EVENT, THE USER MUST ANALYZE RESPCNSE-TtME RESULTS 
WITH A KNOULtOGE OF THESE FACTORS, AND AN UNDERSTANDING OP 
THE OVERLAP BETWEEN USER PROGRAM BUFFERS, MONITOR BUFFERS, 
AND SCRiPT BUFFERS, ALTERNATELY, IF PSYCHOLOGICAL SYSTEM 
PERFORMANCE iS IMPORTANT, THE USER CAN USE THE SYSTEM 
MANUALLY AND SEE HOW CLEVERLY THE SYSTEM IS CONCEALING ITS 
RESPONSE. THE MAIN PURPOSE OF THE SCRIPT PROGRAM IS TO 
OBtAlN CONSjStENT RELATIVE RESPONSE FJGURES TO ASSESS THE 
EFFECT OF HARDWARE AND SOFTWARE CHANGES IN THE TIME'SHARING 
SYSTEM, 
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5.0 FORMAT OF SCRIPT FILES 

5.1 COMMAND LINES 

A SCRIPT FILE CONSISTS OF SCRIPT LINES WHICH END WITH A 
<LINE FEED> CHARACTER. SCRIPT LINES ARE EITHER COMMAND 
LINES OR TEXT LINES, COMMAND LINES ARE USED TO CONTROL 
TYPING AND OPERATION OF THE SCRIPT PROGRAM, TEXT LINES ARE 
SENT OVER THE PSEUDO TELETYPE TO RUN THE OBJECT JOBS, 

5.2 TEXT LINES 

A COMMAND LINE BEGINS WITH ONE EXCLAMATION POINT WHICH IS 
FOLLOWED BY A NON-EXCLAMATION POINT CHARACTER, 

A TEXT LINE BEGINS WITH NO EXCLAMATION POINT, OR WITH TWO 
EXCLAMATION POINTS, IN THIS CASE, ONLY THE SECOND IS SENT 
TO THE OBJECT JOB, IF A SCRIPT LINE BEGINS WITH ONE 
UP-ARROW, THEN THE UP-ARROW IS NOT SENTJ INSTEAD THE NEXT 
CHARACTER IS CONVERTED TO A CONTROL CHARACTER 8Y 
COMPLEMENTING BIT 100, TWO UP-ARROWS RESULT IN ONE UP-ARROW 
BEING SENT, (THE CR/LF AT THE END OF ANY LINE STARTING WITH 
A SINGLE UP-ARROW ARE NOT SENT.J 

NOTE THAT "I" AND "»" HAVE NO SIGNIFICANCE EXCEPT AT THE 
BEGINNING OF A TEXT OR COMMAND LINE, 

5.3 COMMAND LINE SYNTAX 

COMMAND LINES CONSIST OF NUMBERS AND LETTER SWITCHES, 
SWITCHES THAT TAKE NUMERICAL VALUES MAY BE PRCCEEDED BY A 
NUMBER, A NUMBER CONSISTS OF POSSIBLY ONE MINUS SIGN 
FOLLOWED BY A STRING OF DECIMAL DIGITS, THERE CAN BE NO 
SPACES OR TABS BETWEEN THE START AND END OF A NUMBER, AT 
OTHER POINTS. SPACES AND TABS ARE IGNORED IN COMMAND LINES, 

SHOULD A NUMBER NOT BE SPECIFIED, THE LAST NUMBER SUPPLIED 
is ASSUMED, IF NO VALUE HAS BEEN SUPPLIED, A ZERO IS 
ASSUMED AT THE START OF EACH COMMAND LINE, 

CERTAIN LETTER SWITCHES MAY NOT HAVE NUMBERS ASSOCIATED WITH 
THEM. THESE SWITCHES MAY NOT BE PRECEEDED BY A NUMBER 
UNLESS THERE IS AN INTERVENING LETTER SWITCH THAT ALLOWS A 
NUMBER, 

ILLEGAL CHARACTERS OR BAD SYNTAX RESULT IN AN ERROR WHEN 
PROCESSING JOBS. THESE ERRORS ARE NOT DETECTED WHEN THE 
SCRIPT IS LOADED INTO THE HIGH SEGMENT, 
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A COMMAND LINE MAY INCLUDE A COMMENT BY USING A SEMICOLON, 
THE SEMICOLON AND ANY CHARACTERS REMAINING ON THE COMMAND 
LINE ARE DELETED WHEN THE SCRIPT IS LOADED AND SO U3E NO 
CORE AT RUN-TIME. 

A COMMAND LIN£ MUST NOT END WITH A NUMBER, THUS A LETTER 
SWITCH «UST FOLLOW ANY NUMBER IN A COMMAND LINE, 

5,4 LETTtR SWITCHES 

1 IF NON-NESATIVE ARGUMENT SUPPLIED -- SETS TYPE-IN 
BELAY 
if 

NEGATIVE ARGUMENT SUPPLIED — SETS TYPE-IN 
RATE, 

SAME AS i EXCEPT THAT IT SETS TYPE-OUT RATE. 

H IF NON-NEBATIVE ARGUMENT SUPPLIED -- SETS ALLOWED 
RESPONSE TIME 

F IF NON-NEGATIVE ARGUMENT SUPPLIED -- SETS FREE TIME 

S IF NON-NEGATIVE ARGUMENT SUPPLIED — SETS STAGGER TIME 

T IF POSITIVE ARGUMENT SUPPLIED -- SETS NUMBER OF 
TIMtS TO Ofl SCRIPT, 

C if A POSITIVE ARGUMENT SUPPLIED — SETS MAXIMUM 
DELAY BEFORE PROGRAM SENDS tC*C 

if 

ZER? ARGUMENT SUPPLIED — INHIBITS SENDING 



tC»C TIME-OUT 



— SETS L MODE FLAG 
^- CLEARS L MODE 

— SETS U MODE FLAG 

— CLEARS U MODE 



5,9 TIMING UNITS 

TIMES ARE IN MILLISECONDS. RATES ARE IN MILLISECONDS PER 
CHARACTER, 



L 


NO 


ARfiUMtNTS 


ALLOWED 


N 


NO 


ARGUMENTS 
FLAG 


ALLOWED 


U 


NO 


ARGUMENTS 


ALLOWED 


V 


NO 


ARGUMENTS 
FLAG 


ALLOWED 
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5.6 L MODE 

^riEN L M3DE IS SET <CS> AND <LF> WILL NOT BE SENT OVER THE 

PTY. THUS A LIME ENDING WITH <ALTMODE> CAN BE SENT, ANY 

LINE MUST END HOWEVER WITH A FULL CHARACTER SET BREAK 

CHARACTER DUE TO A LI^^ITATION IN THE PTY. 

5.7 U MODE, 

WHEN SET U MODE CONVERTS «#" IN TEXT LINES INTO A STRING OF 
TWO OCTAL DIGITS EQUAL TO THE PTY UNIT NUMBER, (LEADING 
ZEROS WILL BE INCLUDED,) ALL DEC SCRIPTS USE THIS FEATURE 

TO LOG IN The job under ppn 4.77700 through 4,77777 (I,E,, 

4,777#>, 
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6,1! OPERATING INSTRUCTIONS 

6.1 

BUILD A TIME-SHARING SYSTEM »JITH SUFFICIENT JOSS AND 
PSEUDO-TELETYPES. ONE CONTROL JOS WILL BE NEEOED FOR EACH 
14 JOBS FOLLOWING THE SCRIPT. 

6,2 

CREAtE AN APPROPRIATE SCRIPT, 

6,3 

START The SCRIPT PROGRAM. 

6.4 

WHEN IT ASKS IF A SCRIPT IS TO BE LOAOEDi TYPE "YES <CR>'', 

6,5 

TYPE THE DEVICE, FILE- NAME. AND EXTENSION. IF ARGUMENTS ARE 
NOT SUPPLIED. THEY DEFAULT TO DSKlSCRIPT. 

6,6 

THE PROGRAM WILL RESPOND WITH "LOAOEDI". IF THERE WERE 
ERRORS IT WiLL ASK INSTEAD IF A SCRIPT IS TO BE LOADED, CO 
BACK TO STEP 6.4'. 

6.? 

IF THE SCRIPT IS NOT GOING TO BE SHARED GO TO STEP «,10, 

6,B 

RETURN TO MONITOR MODE AND SAVE THE LOADED SCRIPT WITH A 
SSAVe COMMAND, EXAMPLE! "SSAVE DSK SCRIPT <CR>"'. 

6.« 

START N COPIES OF THE PROGRAM BY LOGGING IN N JOBS AND 
GIVING fHE COMMAND "RUN DSK SCRIPT" OR WHAT EVER IS NEEDED 
TO LOAD The SAVED VERSION FROM STEP 6,8, EACH JOB WILL ASK 
IF A SCRIPf IS TO SE LOADED, ANSWER "NO<CR>", THE 
INSTRUCTIONS IN THE REMAINING STEPS SHOULD BE FOLLOWED FOR 
EACH OF THE N JOBS, 
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6,10 

THE PR03RAM 1.IL.L NOW ASK HOW MANY JOBS ARE TO BE RUN. ENTER 
THE NUMBER FOR EACH CONTROL JOB ON ITS TTY, THE MAXMIMUM 
•JUMBER IS 14 JOBS PER CONTROL JOB, EACH OBJECT JOB NEEDS A 
PTY. 

6.11 

THE PTY MAMES WILL BE TYPED OUT AS THEY ARE INITED BY EACH 

SCRIPT JOB. SHOULD THERE BE TOO FEHi THEN THE SCRIPT 

PROGRAM WILL RELEASE ALL GOTTEN SO FAR AND ASK OVER AGAIN 
HOW MANY JOBS ARE TO BE RUN, 

6.12 

THE FIRST JOB RUN BY A GIVEN SCRIPT JOB CAN BE MONITORED ON 
DEVICE TTY, THIS IS USEFUL FOR DEBUGGING A NEW SCRIPT, 
ANSWER THE QUESTION "DO YOU WANT TO WATCH FIRST JOB ON TTY?" 
APPROPRIATELY. INCIDENTALLYi IF DEVICE TTY HAS BEEN 
ASSIGNED TO A DIRECTORY DEVICE, THIS OUTPUT WILL BE GIVEN 
THE FILE NAME "MONITR"', SHOULD THE DEVICE BE UNAVAILABLE, 
OR THE FILE UNENTERASLE, AN ERROR MESSAGE HILL APPEAR ON THE 
TELETYPE AND THE QUESTION WILL BE ASKED AGAIN, 

SHOULD AN ERROR OCCUR ON DEVICE TTY WHILE RUNNING, THE RUN 
WILL NOT BE SUSPENDED. HOWEVER, SUBSEQUENT MONITORING HILL 
BE INHIBITED. 

6,13 

IF THE SCRIPT CALLS FOR FASTER OUTPUT THAN DEVICE TTY CAN 
HANDLE. THEN THE SCRIPT JOB WILL GO INTO I/O WAIT, THIS 
WILL RESULT IN VERY LONG DELAY TIMES ATTRIBUTED TO THE 
SCRIPT PROGRAM, THIS CONDITION SHOULD BE AVOIDED BY 
CHANGING THE SCRIPT PARAMETERS, USING A FASTER DEVICE TTY OR 
NOT MONITORING AT ALL, 

6,14 

THE PROGRAM WILL NOW ASK, "00 YOU WANT RESPONSE TIMES 
LQGGEOt" A "NO<CR>» ANSWER WILL CAUSE THE SCRIPT TO BEGIN, 
IN THIS CASE, GO TO STEP 6,16, 

6,15 

IF THE QUESTION WAS ANSWERED "YES<CR>", THE PROGRAM WILL 
ASKED FOR A DEVICE, FILE NAME AND EXTENSION. ARGUMENTS NOT 
SUPPLIED WILL DEFAULT TO OSKlLOGFIL, 
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IF THE DEVICE IS NOT AVAILABLE, OR IF THE FILE CAN 
ENTERED, GO BACK TO STEP 6.i4. 



NOT BE 



SHOULD A DATA ERROR OCCUR WHILE RUNNING, THE RUN MILL 
PROCEED WITH SUBSEQUE>4T LOGGING INHIBITED. AN ERROR MESSAGE 
WILL APPEAR ON THE TELETYPE. 

6.16 

JOBS UNDER CONTROL OF A GIVEN CONTROL PROGRAM WILL 9E 
STAGGERED BY AN INTERVAL SPECIFIED IN THE SCRIPT. IF 
MULTIPLE SCRIPT JOBS ARE RUNNING, THE USER CAN STAGGER THEIR 
TIMING BY ENDING STEP «.14 OR 6.15 AT THE APPROPRIATE TIME 
OF DAY. 

6,17 

WHEN THE LAST JOB UNDER A GIVEN SCRIPT PROGRAM HAS FINISHED, 
THE MESSAGE "ALL JOBS DONE!" WILL APPEAR ON THE USERS 
TELETYPE AND THE LOO FILE AND MONITOR FILE WILL BE CLOSED, 
THE PROGRAM WRL THEN EXIT, 



NOTE THAt IF MULTIPLE JOBS ARE RUNNING THE 
WELL BE OVER A LONG TIME BEFORE THE LAST, 
MONITORED ON DEVICE TTY, 

6,18 



FIRST JOB MAY 
THIS IS THE JOB 



SHOULD IT BE NECESSARY TO TERMINATE A RUN, STOP THE CONTROL 
PROGRAM BY tYPING TWO <CONTROL O CHARACTERS, TO CLOSE OUT 
THE LOS FILE REENTER THE PROGRAM BY A REENTER COMMAND, A 
MESSAGE "JOBS ABORTEDI" WILL APPEAR ON THE TELETYPE, 

IN CASE tHIS IS DONE, BE AWARE THAT ANY JOBS RUNNING UNDER 

SCRIPT PROGRAM CONTROL HILL NOW BE DETACHED, THE USER 

SHOULD K!LL tHESE JOBS OFF OR DO A 143 MONITOR RESTART To 
FLUSH ALL JOBS, 



6,19 

THE FORTRAN PROGRAM TOTAL 
RESPONSE LOS FILE, IT 



PLACES A SHORT LISTING ON 6IFOR06,DAT, 



CAN BE USED TO SUMMARIZE THE 
TAKES INPUT FROM 11F0RB1,DAT AND 



DMPFIL IS A riLE DUMP PROGRAM; IT READS A FILE AND PREPARES A PRINTABLE 
VERSION OF AN OCTAL DUMP OF THE FILE. IT WILL ALSO DUMP A DECTAPE 
3L0CK BY BLOCK. CR DUMP A SAVE FILE AS A CORE DUMP. OR A DISK FILE 

STRUCTURE BLOCK BY BLOCK'. 

ASSEMBLY INSTRUCTIONS; 

.COMPILE DMPFIL 

THERE ARE NO ASSEMBLY OPTIONS 
RUN INSTRUCTIONS! 

.R DMPFIL 

•<OUtPUT FlLE>»<iNPUT FILE>/SWITCHES 

SWITCHES! 

MNNNNND - DUMP DECTAPE, BEGINNING AT BLOCK NKNNNN (OCTAL) 
INCLUDES LISTING OF DIRECTORY 

NNNNNNK - ASSUME FILE JS SAVE FILE, DUMP AS CORE DUMP, BEGINNING AT LOC NNNNNN 
NNNNNNH - ASSUME FILE IS HIGH SEGMENT SAVE FILE, DUMP AS CORE DUMP 

.VNNNMNS - DUMP DISK, BEGINNING AT BLOCK MNNNNN(OCTAL) , USING SUPER U8ETI 

MNNNNNT » STOP DUMP AT NNNNNN<OCTAL>- 

DEFAULT OUTPUT FILE IS LPTJ ,LST 

DEFAULT INPUT FILE IS DSKI 

DEFAULT IS THE SAME FILE ON BOTH SIDES 
IF NO "»", INPUT FILE IS SPECIFIED 
'•s" CAN BE USED FOR "►" 

REENTER WILL CLOSE THE FILES. 



